home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / echo311.zip / ECHODOR.TXT < prev    next >
Text File  |  1992-03-16  |  204KB  |  6,810 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.           ******   ******  *     *   *****   *****     *****    *****
  16.          *        *        *     *  *     *  *     *  *     *  *     *
  17.          ****     *        *******  *     *  *     *  *     *  ******
  18.          *        *        *     *  *     *  *     *  *     *  *  *
  19.          *        *        *     *  *     *  *     *  *     *  *   *
  20.           ******   ******  *     *   *****   *****     *****   *    *
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                            EchoDor version 3.11
  34.                       Original Program By Scott Baker
  35.                     Modifications by Robert McCullough
  36.                       Documentation by Jonathan Woods
  37.  
  38.              If you should happen to find this program useful,
  39.                       Please send a contribution to:
  40.  
  41.                              Robert McCullough
  42.                               P.O. Box 101095
  43.                            Nashville, TN  37224
  44.                          Voice Phone 615 256-2444
  45.  
  46.               For the latest version of EchoDor, you may call
  47.  
  48.                      The NEW WorkBench BBS (9600/Hst)
  49.                           BBS Phone 615 256-2211
  50.                          FidoNet Node 1:116/1000.0
  51.                             RBBS Net 8:967/1.0
  52.                         File Requestable as ECHODOR
  53.  
  54.  
  55. EchoDor Version 3.11
  56. 3/16/92
  57.  
  58.  
  59. Introduction                                           1
  60.  
  61. Installation                                           2
  62.  
  63.      DoorDriv.Ctl parameter file                       5
  64.  
  65.      Multiple DoorDriv.Ctl files                       5
  66.  
  67.      Parameters                                        6
  68.  
  69.      Color Table                                       12
  70.  
  71.      Special instructions                              13
  72.           PC Board 14                                  13
  73.           PC Board 12                                  13
  74.           Opus 1.7x                                    13
  75.           GT PowerComm                                 13
  76.           Genesis Deluxe                               13
  77.           LINE-A operation                             13
  78.           LINE-B operation                             14
  79.  
  80.      ECHODOR.CTL parameter file                        15
  81.           Display file naming                          15
  82.  
  83.      Parameters                                        16
  84.  
  85.      Color Table                                       32
  86.  
  87.      SYSOP setup                                       33
  88.  
  89.      Pack Mail / Compress / Download Setup             34
  90.           Basic Setup                                  34
  91.           Compressing Mail                             35
  92.           Downloading Mail                             36
  93.  
  94.      Multiple Node Setup                               38
  95.           The Common Directory Method                  39
  96.           Multiple Directory Method                    42
  97.  
  98.      Multiple Net Setup                                45
  99.  
  100. Purging & Renumbering Areas                            47
  101.  
  102.      The Three Step Method                             47
  103.  
  104.      EDorPurg                                          49
  105.           Setup                                        49
  106.           EDorPurg Parameters                          51
  107.           Operation                                    53
  108.           Recovery Method                              54
  109.  
  110.      FastLink                                          55
  111.           Parameters                                   55
  112.           Operation                                    57
  113.  
  114.                                   Page i
  115.  
  116.  
  117. EchoDor Version 3.11
  118. 3/16/92
  119.  
  120.  
  121. EchoDor Operation                                      59
  122.  
  123.      Menu Commands                                     59
  124.  
  125.      Reading messages                                  60
  126.  
  127.      Entering messages                                 62
  128.           Line Editor                                  62
  129.           Full Screen Editor                           64
  130.           Insert Mode versus Over type Mode            66
  131.           Keyboard emulation                           66
  132.           Visual Quote                                 67
  133.  
  134.      Using EchoDor Locally                             68
  135.  
  136.      Special local keys                                69
  137.  
  138.      Message Header Description                        70
  139.  
  140. How do file-requests work?                             72
  141.  
  142. File-attaches                                          74
  143.  
  144. Auto Messages                                          76
  145.  
  146. General information                                    77
  147.  
  148. EchoUser Program                                       78
  149.  
  150.      User File Records                                 78
  151.           Default User & Maintenance Record            78
  152.           User Records                                 79
  153.  
  154.      Remote Operation                                  80
  155.  
  156. Using SCANMRG                                          81
  157.  
  158. The EchoDor Nodelist compiler                          82
  159.  
  160.      How it works                                      82
  161.  
  162.      The Control file                                  82
  163.  
  164.      Running EchoNLCP                                  83
  165.  
  166. EchoNLRD node list reader                              84
  167.  
  168. Opus 1.1x Converter (OPUSCNVT)                         85
  169.  
  170. Support for EchoDor                                    86
  171.  
  172. Revision History                                       87
  173.  
  174.      3.11 revisions                                    87
  175.  
  176.                                   Page ii
  177.  
  178.  
  179. EchoDor Version 3.11
  180. 3/16/92
  181.  
  182.  
  183.      3.10a revisions (we didn't release a 3.10):       90
  184.  
  185.      3.09 revisions:                                   92
  186.  
  187.      3.08 revisions:                                   95
  188.  
  189. Run Time Errors                                        97
  190.  
  191. Plans for next version                                 103
  192.  
  193. Registration                                           104
  194.  
  195. Disclaimer                                             105
  196.  
  197. Guarantee                                              106
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.                                  Page iii
  239.  
  240.  
  241. EchoDor Version 3.11
  242. 3/16/92
  243.  
  244.  
  245. Introduction
  246.  
  247. EchoDor is a full featured echo mail conference processor that incorporates
  248. features found in many door programs, and bulletin board systems.  The Echo
  249. mail community has for some time been lacking a really good echo mail door.
  250. It is due to this lack that EchoDor was created.
  251.  
  252. EchoDor may be used on several BBS systems.  It is configurable to run
  253. under RBBS-PC Ver CPC 15.1 through 17.2, PCBOARD 14.1, and Quickbbs.  The
  254. difference between these BBS systems is the way they handle passing
  255. information to a  Door program.  RBBS 15.1 puts the information in the
  256. first record of the message file.  RBBS 16.1+ creates a  small text file
  257. called DORINFOx.DEF.  (the  'x'  being  the node number that called the
  258. door program).  PCBOARD creates a random access file called PCBOARD.SYS.
  259. Quick BBS passes all the parameters on the command line that calls the
  260. door.
  261.  
  262. The information that is passed includes the Users Name, the Communications
  263. Port, the baud rate, the graphics type selected, the time remaining, and
  264. the sysop name.  This information is used by EchoDor to monitor the carrier
  265. of the appropriate port, and to control various other functions of EchoDor.
  266.  
  267. If you don't have echo mail currently operating, you probably don't have a
  268. need for this program.  If you are adding  echo mail to your system, and
  269. haven't completed installing it yet, STOP.  Go back to the echo mail
  270. programs, and get that working FIRST!  You should set up echo mail to work
  271. in a set of subdirectories like FIDO, OPUS, and the rest of the net mail
  272. bulletin boards.  If you are using RBBS, DO NOT USE RBBSMAIL! RBBSMAIL puts
  273. the echo mail messages in your RBBS conference files!  EchoDor can't
  274. support this feature!
  275.  
  276. If you are using PC Board or QuickBBS, the installation procedures are the
  277. same as for RBBS.
  278.  
  279. Thus far PCBOARD does not support a net mail front end processor due to the
  280. fact that it does not allow parameters to be passed on the command line.
  281. To support echo mail using PCBOARD, BinkleyTerm has to be run in the "MAIL"
  282. mode as an event from PCBOARD each evening.  Due to this, PCBOARD sysops
  283. cannot support Crash mail.  Also, PCBOARD does not provide EchoDor will
  284. security levels; therefor, security level access control will not work.
  285. EchoDor provides a "default" security for all users of 50 when running with
  286. PCBOARD.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                   Page 1
  301.  
  302.  
  303. EchoDor Version 3.11
  304. 3/16/92
  305.  
  306.  
  307. Installation
  308.  
  309. If you already have net mail running, the installation will be very simple.
  310. If you don't run net mail, some explanation is in order.
  311.  
  312. EchoDor uses FIDO type messages.  IE: each message is a separate file
  313. (1.MSG, 2.MSG etc..).  The messages in each area (Conference/Forum) are
  314. stored in their own Subdirectory.  EG:
  315.  
  316. C:\------ BBS
  317.      |
  318.      +--- MAIL ------- PRIVATE
  319.      |
  320.      +--- BAD_MSGS
  321.      |
  322.      +--- HUMOR
  323.      |
  324.      +--- RBBS-PC
  325.      |
  326.      +--- CHATTER
  327.      |
  328.      +--- POLITICS
  329.  
  330. You need to get echo mail processor to  move all your incoming messages to
  331. subdirectories like these. Examples of programs that do this are ConfMail,
  332. QM (or QMail), or TossScan.
  333.  
  334. Set up this subdirectory structure BEFORE proceeding to the next section!
  335.  
  336. You must also set up a fossil for EchoDor to use to communicate with the
  337. modem.  A number of fossil programs are available including X00, BNU, or
  338. OPUS!COM.  Get one of these if your not already using one and get it
  339. installed.
  340.  
  341. Then:
  342.  
  343. Create a directory to hold all the files in the EchoDor archive.
  344.  
  345. Unpack the archive into the directory.
  346.  
  347. Edit the file DoorDriv.Ctl to reflect the information about your system.
  348. Follow the comments contained in the file.
  349. Enter your first name as SYSOPFIRST name.
  350.  
  351. Enter your last name as SYSOPLAST name.
  352.  
  353. Enter your BBS name as BBSNAME name.
  354.  
  355. Select your BBS type as BBSTYPE.  If your BBS type is not listed, you may
  356. have to run EchoDor with some converter program.
  357.  
  358. Place the drive and directory of your BBS into the line marked BBSPATH.
  359. This tells EchoDor where to get the door information file.
  360.  
  361.  
  362.                                   Page 2
  363.  
  364.  
  365. EchoDor Version 3.11
  366. 3/16/92
  367.  
  368. If you run a "locked baud", uncomment the line BAUD and set your baud rate.
  369. This will override the baud specified in the door drop file.
  370. We'll leave the rest of the entries as they are for now.  See the following
  371. sections for a complete list of parameters and their uses.
  372.  
  373. Edit the file "ECHODOR.CTL" to reflect information about the echos you
  374. intend to carry.  Follow the comments in the file.
  375.  
  376. Enter your own zone, net and node numbers.
  377.  
  378. Enter your name as SYSOPNAME name.
  379.  
  380. Enter your name as COMMENTNAME name.
  381.  
  382. Edit the 2 tables, AREATABLE and AREADESC to your own echo mail areas. The
  383. comments in the file should explain how to do this.  See also the section
  384. titled ECHODOR.CTL parameter file.
  385.  
  386. Now run:
  387.  
  388.      EchoUtil /USERFILE
  389.  
  390. EchoUtil will ask if you want Hot keys on as the default.  Answer either Y
  391. or N.  EchoUtil will create the user file.
  392.  
  393. Run the CheckOut program.  This program checks a lot of the entries and
  394. will help you resolve a number of problems.  If Checkout generates too much
  395. output for your screen, you can redirect the output to your printer by
  396. using the command:
  397.  
  398.      Checkout > PRN
  399.  
  400. Set up a door batch file to something like the following:
  401.  
  402.      rem
  403.      rem switch to the EchoDor directory and start
  404.      rem EchoDor
  405.      rem
  406.      CD \EchoDor
  407.      rem
  408.      rem now run EchoDor and pass it the node number
  409.      rem in this example the node number is passed as
  410.      rem the first parameter of the batch file.  If you
  411.      rem only run a single node, change the %1 to 1.
  412.      rem
  413.      rem      | this is the parameter which is the port
  414.      rem      | number.  All other information will come
  415.      rem      | from the bbs door file.
  416.      rem      v
  417.      ECHODOR %1
  418.      rem
  419.      CD \rbbs
  420.      rbbs
  421.  
  422.      (SEE the Example Batch file called ECHODOR.BAT)
  423.  
  424.                                   Page 3
  425.  
  426.  
  427. EchoDor Version 3.11
  428. 3/16/92
  429.  
  430.  
  431.      Note:
  432.           make sure that your batch file copies dorinfo*.def
  433.           to the EchoDor directory. This is a very important
  434.           file.
  435.  
  436. Test the door in local mode with "ECHODOR /L" to make sure it is working.
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                                   Page 4
  487.  
  488.  
  489. EchoDor Version 3.11
  490. 3/16/92
  491.  
  492.  
  493. DoorDriv.Ctl parameter file
  494.  
  495. The DoorDriv.Ctl file controls the door's interaction with the
  496. communication port and provides information about the BBS type that is
  497. calling the door.  This file is required and must be in the default
  498. directory when the door program is started.  The DoorDriv.Ctl example file
  499. contains a number of comments which should help you in editing this file.
  500. This chapter contains a list of all the parameters for DoorDriv.Ctl and
  501. their use.
  502.  
  503. Multiple DoorDriv.Ctl files
  504.  
  505. It is sometimes necessary to have multiple DoorDriv.Ctl file when running a
  506. multiple line system.  One modem might be one speed or different monitors
  507. might be used on different nodes.  Door Driver now supports multiple
  508. control files.
  509.  
  510. The specific file selected depends on the "node" number specified when
  511. starting the door.  Local operation always uses "node" zero (0).  The name
  512. of the file comes from replacing the last character of the file name
  513. (before the period) with the node number.  If that file dose not exist,
  514. Door Driver will then look for the base file (DoorDriv.Ctl).  The different
  515. control files might be named:
  516.  
  517.      DoorDriv.Ctl       < base file used as default >
  518.      DoorDri0.Ctl       < used for node 0 (local)   >
  519.      DoorDri1.Ctl       < used for node 1 >
  520.      DoorDri2.Ctl       < used for node 2 >
  521.           .
  522.           .
  523.      DoorDriX.Ctl       < X = node number >
  524.  
  525. Up to nine nodes plus local is supported.  Remember that some doors change
  526. the name of the Door Driver control file.  The naming would be altered to
  527. use the new base name.
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.                                   Page 5
  549.  
  550.  
  551. EchoDor Version 3.11
  552. 3/16/92
  553.  
  554.  
  555.  
  556. Parameters
  557.  
  558. BACKGROUND
  559.  
  560.      This parameter specifies the default background color used by the door
  561.      program.  See the list of available colors at the end of this section
  562.      for the color numbers that can be used.  Only the numbers 0-7 can be
  563.      used here.  The format of this command is:
  564.  
  565.           BACKGROUND n
  566.  
  567.           Where n is the color number desired as the default background
  568.           color for the door.  Note that some doors may not honor this
  569.           parameter and use other colors.
  570.  
  571. BAUD
  572.  
  573.      This parameter is used to set the baud rate of the door if you use a
  574.      system that runs a locked baud.  The format of this parameter is:
  575.  
  576.           BAUD xxxxx
  577.  
  578.           The following fixed BAUD rates are supported:
  579.  
  580.                300, 600, 1200, 2400, 4800, 9600, 19200, 38400
  581.  
  582.           If this parameter is not used the baud rate used will be the baud
  583.           in the door control file written by the BBS system.
  584.  
  585. BBSNAME
  586.  
  587.      This parameter is the name of the BBS that you want to have displayed
  588.      to the user when the door closes.  This parameter is required.  The
  589.      format of this line should be:
  590.  
  591.           BBSNAME name of my board
  592.  
  593.           DO NOT put quotes around the name of your board or they'll show,
  594.           just enter the name as you would type it.
  595.  
  596. BBSPATH
  597.  
  598.      Most doors require you to copy your door information file (written by
  599.      your BBS) into the directory where the door resides.  By setting
  600.      BBSPATH, you instruct this door to read the door information file from
  601.      the specified drive and directory.  This avoids you having to copy the
  602.      file and reduces start up time.
  603.  
  604.      This parameter is optional.  If it is not specified, the door will
  605.      look for the door information file in the current directory.
  606.  
  607. BBSTYPE
  608.  
  609.  
  610.                                   Page 6
  611.  
  612.  
  613. EchoDor Version 3.11
  614. 3/16/92
  615.  
  616.      Most doors will only run with a specific type of BBS.  This door will
  617.      run with a number of different types of BBS systems.  To tell the door
  618.      the type of BBS you have you must set the BBS type.  This is a
  619.      required parameter.  The format of this parameter is:
  620.  
  621.           BBSTYPE type
  622.  
  623.           The type should be replaced with one of the following:
  624.  
  625.                RBBS    - for RBBS-PC 16.1+  (DORINFOx.DEF file)
  626.                RA      - for Remote Access  (DORINFOx.DEF file)
  627.                QUICK   - for QuickBBS       (DORINFO1.DEF file)
  628.                PCB12   - for PC-Board 12.
  629.                PCB14   - for PC-Board 14.
  630.                WWIV    - WWIV BBS           (CHAIN.TXT file)
  631.                PHOENIX - Phoenix BBS        (INFO.BBS)
  632.                WILDCAT - for WildCat! BBS   (CALLINFO.BBS file)
  633.                OPUS17x - for Opus 1.7x      (LASTUS##.DAT file)
  634.                GT      - for GT PowerComm   (GTUSER.BBS file)
  635.                GENESIS - for Genesis Deluxe (CALLINFO.BBS file)
  636.                WC3.0   - for WildCat! BBS   (DOOR.SYS file)
  637.                GAP     - for GAP bbs        (DOOR.SYS file)
  638.                LINE-A  - command line parameters (see below)
  639.                LINE-B  - command line parameters (see below)
  640.  
  641. CHATSYSOPCOLOR
  642.  
  643.      This parameter specifies the color to use for the SYSOP when in chat
  644.      mode.  The format of the command is:
  645.  
  646.           CHATSYSOPCOLOR nn
  647.  
  648.           Where nn is the color number desired for the color to use for
  649.           text typed by the SYSOP during chat mode.  See the list of
  650.           available colors at the end of this section.  The default for
  651.           this parameter is "yellow" (14).
  652.  
  653. CHATUSERCOLOR
  654.  
  655.      This parameter specifies the color to use for the USER when in chat
  656.      mode.  The format of the command is:
  657.  
  658.           CHATUSERCOLOR nn
  659.  
  660.           Where nn is the color number desired for the color to use for the
  661.           text typed by the USER during chat mode.  See the list of
  662.           available colors at the end of this section.  The default for
  663.           this parameter is "light blue" (9).
  664.  
  665. COLOR1
  666.  
  667.      Some BBS systems set the color indicator differently than the door
  668.      expects.  If your users do not get color when they should, try
  669.      including this parameter in the DoorDriv.Ctl file.
  670.  
  671.  
  672.                                   Page 7
  673.  
  674.  
  675. EchoDor Version 3.11
  676. 3/16/92
  677.  
  678. COMPORT
  679.  
  680.      Some BBS systems do not write the communications port number to the
  681.      door control file.  One example of this is PC-Board version 12.  If
  682.      you run a BBS of this type, you must tell the door which
  683.      communications port to use by using this parameter.  The format of
  684.      this parameter is:
  685.  
  686.           COMPORT x
  687.  
  688.           Where x is a 1, 2 .... maximum port.
  689.  
  690. DIRECTVIDEO
  691.  
  692.      The door uses BIOS type writes to display information on the local
  693.      screen.  This mode is best for people that run DV.  If you want faster
  694.      screen writes, include the DIRECTVIDEO parameter and the system will
  695.      use direct screen writes.
  696.  
  697. FOREGROUND
  698.  
  699.      This parameter specifies the default foreground color used by the door
  700.      program.  See the list of available colors at the end of this section
  701.      for the color numbers that can be used.  The format of this command
  702.      is:
  703.  
  704.           FOREGROUND nn
  705.  
  706.           Where nn is the color number desired as the default foreground
  707.           color for the door.  Note that some doors may not honor this
  708.           parameter and use other colors.
  709.  
  710. HILIGHTCOLOR
  711.  
  712.      This parameter specifies the color to be used for highlight.  See the
  713.      list of available colors at the end of this section for the color
  714.      numbers that can be used.  The format for this command is:
  715.  
  716.           HILIGHTCOLOR nn
  717.  
  718.           Where nn is the color number desired as the default foreground
  719.           highlight color for the door.  Note that some doors may override
  720.           this parameter.
  721.  
  722. IDLETIME nn
  723.  
  724.      This specified the maximum idle time in seconds between keystrokes.
  725.      When 2/3rds of the idle time has passed, the program will issue a
  726.      beep.  When the total time lapses and no keystroke has been make, the
  727.      door will exit.
  728.  
  729.      This may be disabled by setting IDLETIME 00.
  730.  
  731. MAXTIME nn
  732.  
  733.  
  734.                                   Page 8
  735.  
  736.  
  737. EchoDor Version 3.11
  738. 3/16/92
  739.  
  740.      This parameter is used to specify the maximum time the user is allowed
  741.      in the door.  Some BBS systems require this parameter because the time
  742.      remaining is not passed.  GT is an example of this.
  743.  
  744.      In boards where the maximum time is passed, if the user has more time
  745.      available than the value specified here, the users time for the door
  746.      will be reduced to the specified MAXTIME.  Maximum time is specified
  747.      in minutes.
  748.  
  749.      This may be disabled by setting MAXTIME 00.
  750.  
  751. MINTIME nn
  752.  
  753.      This parameter allows you to set the minimum amount of time the user
  754.      must have remaining to be able to use the door.  If the total time
  755.      remaining is less than the time specified, the user will be told that
  756.      he doesn't have enough time and the door will exit.  Minimum time is
  757.      specified in minutes.
  758.  
  759.      This may be disabled by setting MINTIME 00.
  760.  
  761. MONO
  762.  
  763.      This parameter if present will disable color on the local display.
  764.      This is required if you run a monochrome monitor.
  765.  
  766. NOTIME filename
  767.  
  768.      This parameter if present will allow you to tell the door to display a
  769.      file when the user runs out of time.
  770.  
  771. PROMPTCOLOR c1 c2 c3
  772.  
  773.      This parameter defines the colors used for some requests made by the
  774.      door.  All three items are color numbers from the list below.  The
  775.      first color number (c1) is the foreground color of the input field.
  776.      The second color number (c2) is the background color of the input
  777.      field.  The third color number (c3) is the foreground color number of
  778.      the "Prompt Text".
  779.  
  780. QUIET
  781.  
  782.      This parameter will prevent ^G (bell) characters from ringing the bell
  783.      on the local system.
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                   Page 9
  797.  
  798.  
  799. EchoDor Version 3.11
  800. 3/16/92
  801.  
  802. STATFORE
  803.  
  804.      This parameter is the foreground color of the status line.  If the
  805.      status line is off (see the STATUS parameter) this command has no
  806.      effect.  Refer to the list of colors at the end of this section for
  807.      the color numbers that can be used.  The format of this command is:
  808.  
  809.           STATFORE nn
  810.  
  811.           Where nn is the color number desired for the status line
  812.           foreground color.
  813.  
  814. STATBACK
  815.  
  816.      This parameter is the background color of the status line.  If the
  817.      status line is off (see the STATUS parameter) this command has no
  818.      effect.  Refer to the list of colors at the end of this section for
  819.      the color numbers that can be used.  The format of this command is:
  820.  
  821.           STATBACK nn
  822.  
  823.           Where nn is the color number desired for the status line
  824.           background color.
  825.  
  826. STATUS
  827.  
  828.      This parameter turns the status line on the local side on and off.  I
  829.      suggest you try it turned on.  If the status line causes problems then
  830.      turn it off.  The format of the command is:
  831.  
  832.           STATUS ON
  833.  
  834.           or
  835.  
  836.           STATUS OFF
  837.  
  838.           Note:     Some doors disable the status line when running in
  839.                Local Mode.
  840.  
  841. SWAPFILENAME
  842.  
  843.      If it is desirable to have the door swap itself out of memory when
  844.      shelling to DOS, this parameter must be specified.  If the parameter
  845.      is not specified, the door will remain in memory when a "shell to dos"
  846.      is requested.  If the parameter is specified AND there is available
  847.      EMS to use, the door will be swapped to EMS in place of disk.  The
  848.      format of this parameter is:
  849.  
  850.           SWAPFILENAME <filename>
  851.  
  852.           Where <filename> is a drive/path/name of the file to be used by
  853.           the door when swapping itself out of memory.  If the path is not
  854.           specified, the default start up path for the door will be used.
  855.           If the <name> part of the <filename> contains a pound symbol (#),
  856.           the pound symbol will be replaced by the node number of the
  857.  
  858.                                   Page 10
  859.  
  860.  
  861. EchoDor Version 3.11
  862. 3/16/92
  863.  
  864.           running door.  DO NOT ALLOW two copies of the door to use the
  865.           same swap file!! .
  866.  
  867. SYSOPFIRST
  868.  
  869.      This is the first name of the SYSOP.  This parameter is required and
  870.      should be entered as:
  871.  
  872.           SYSOPFIRST Name
  873.  
  874. SYSOPLAST
  875.  
  876.      This is the last name of the SYSOP.  This parameter is required and
  877.      should be entered as:
  878.  
  879.           SYSOPLAST Name
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                   Page 11
  921.  
  922.  
  923. EchoDor Version 3.11
  924. 3/16/92
  925.  
  926.  
  927. Color Table
  928.  
  929. The follow colors may be used for both background colors and foreground
  930. colors:
  931.  
  932.            0 - Black
  933.            1 - Blue
  934.            2 - Green
  935.            3 - Cyan
  936.            4 - Red
  937.            5 - Magenta
  938.            6 - Brown
  939.            7 - Light Gray
  940.  
  941. The following colors may be used only for foreground colors:
  942.  
  943.            8 - Dark Gray
  944.            9 - Light Blue
  945.           10 - Light Green
  946.           11 - Light Cyan
  947.           12 - Light Red
  948.           13 - Light Magenta
  949.           14 - Yellow
  950.           15 - White
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.                                   Page 12
  983.  
  984.  
  985. EchoDor Version 3.11
  986. 3/16/92
  987.  
  988.  
  989. Special instructions
  990.  
  991. PC Board 14
  992.  
  993.      When using this door with PC Board 14 systems, a default security
  994.      level of 50 is assigned all users.
  995.  
  996. PC Board 12
  997.  
  998.      When using this door with PC Board 12 systems, a default security
  999.      level of 50 is assigned to all users.
  1000.  
  1001.      PC Board 12 also requires that the COMPORT parameter be specified.
  1002.  
  1003. Opus 1.7x
  1004.  
  1005.      When using the door with Opus 1.7x systems, the following security
  1006.      levels will be used:
  1007.  
  1008.           Twit                32
  1009.           Disgrace            48
  1010.           Limited             64
  1011.           Normal              80
  1012.           Worthy              96
  1013.           Privel              112
  1014.           Favored             128
  1015.           Extra               144
  1016.           Clerk               160
  1017.           Asst-Sysop          176
  1018.           Sysop               208
  1019.  
  1020. GT PowerComm
  1021.  
  1022.      If you use this Door with GT PowerComm, you must set the MAXTIME
  1023.      parameter.  The GTUSER.BBS file does not contain the amount of time
  1024.      remaining for the door.
  1025.  
  1026. Genesis Deluxe
  1027.  
  1028.      When using this Door with Genesis Deluxe, you must set the COMPORT
  1029.      parameter.
  1030.  
  1031. LINE-A operation
  1032.  
  1033.      This option is provided to allow doors to be called without door
  1034.      information files.  All needed parameters are passed on the command
  1035.      line.  The order of the parameters is not important; however, if you
  1036.      wish to use multiple DoorDriv.Ctl files, you must specify a port
  1037.      number (without a leading slash or dash) as the first parameter on the
  1038.      command line.  Every other parameter begins with either a slash (/) or
  1039.      a dash (-) followed immediately by a single letter parameter type.
  1040.      That type is then followed immediately by the parameter.  There should
  1041.      be no spaces between the dash/slash and the parameter type and there
  1042.  
  1043.  
  1044.                                   Page 13
  1045.  
  1046.  
  1047. EchoDor Version 3.11
  1048. 3/16/92
  1049.  
  1050.      should be no spaces between the parameter type and the parameter.  For
  1051.      example:  -b2400 is valid, -b 2400 is not valid.
  1052.  
  1053.      The following parameters can be specified:
  1054.  
  1055.           -B   baud rate.  A baud rate of zero is assumed local.
  1056.  
  1057.           -P   communication port number, COM1 is -P0.
  1058.  
  1059.           -T   time remaining.  This is specified in minutes.
  1060.  
  1061.           -N   users name.  If specifying a users first & last name, use an
  1062.                underscore as a separator.  For example:
  1063.  
  1064.                     -NFirst_Last
  1065.  
  1066.           -S   numeric security level.  For example: -S50 is security level
  1067.                50.
  1068.  
  1069.           -M   sets the maximum time allowed in door.  If the time
  1070.                remaining is greater than the maximum time, the maximum time
  1071.                will be used.  This is specified in minutes.
  1072.  
  1073.           -G   Specifies graphics/ansi.  If the -G is followed by 0,
  1074.                graphics will be disabled.  If the -G is followed by a non
  1075.                zero value, graphics will be enabled.
  1076.  
  1077.      If you wish to use a "node number" this must be specified as the first
  1078.      parameter without a slash or dash.
  1079.  
  1080.      These parameters should not be used with the /S (sysop log on) or the
  1081.      /L (local log on) options.
  1082.  
  1083. LINE-B operation
  1084.  
  1085.      This parameter is provided to allow doors to be called without door
  1086.      information files.  All needed parameters are passed on the command
  1087.      line.  Every parameter is order dependent.  This style of operation
  1088.      does not allow user names and provides a default security level of 50.
  1089.      The following command line is used:
  1090.  
  1091.           door <port> <baud> <time> <maxtime>
  1092.  
  1093.           <port>    this is the communication port to be used. 1 is assumed
  1094.                     to be COM1.  A port of 0 is assumed local.
  1095.  
  1096.           <baud>    this is the baud rate.  A baud rate of zero is assumed
  1097.                     local.
  1098.  
  1099.           <time>    this is the time remaining.  It's value is in minutes.
  1100.  
  1101.           <maxtime> this is the maximum time allowed in the door.  If the
  1102.                     <time> parameter is greater than the <maxtime>
  1103.                     parameter, the <maxtime> parameter will be used.  This
  1104.                     parameter is optional.
  1105.  
  1106.                                   Page 14
  1107.  
  1108.  
  1109. EchoDor Version 3.11
  1110. 3/16/92
  1111.  
  1112. ECHODOR.CTL parameter file
  1113.  
  1114.      ECHODOR.CTL is EchoDor's master configuration file.  All communication
  1115.      between you and EchoDor is through this file.  Node Number, Net
  1116.      Number, Sysop name, and many more parameters get their values from
  1117.      this file.  An example file is distributed with EchoDor and is well
  1118.      commented.
  1119.  
  1120. Display file naming
  1121.  
  1122.      Some of the parameters in the ECHODOR.CTL file specifies files which
  1123.      can be displayed to the user.  Examples of such files are the menu
  1124.      files (as specified by the MENUFILE, PACKMENUFILE, and DOWNLOADTEXT
  1125.      parameter) and the welcome files (as specified by the WELCOME
  1126.      parameter).
  1127.  
  1128.      EchoDor supports 3 types of displays:
  1129.  
  1130.           1. Basic text display
  1131.           2. Graphics display
  1132.           3. ANSI color display
  1133.  
  1134.      When EchoDor displays a file and the specified file has an extension
  1135.      specified, that file will be displayed to the user regardless of the
  1136.      type of display.
  1137.  
  1138.      If the file does not have an extension specified then EchoDor will add
  1139.      an extension to the file depending on display type.  The selection
  1140.      will be:
  1141.  
  1142.           file.ANS if the user has ANSI color
  1143.  
  1144.           file.ASC if the user has Graphics
  1145.  
  1146.           No extension will be added if the user has basic text.
  1147.  
  1148.      If the user has ANSI color and EchoDor cannot find the specified file
  1149.      with the extension .ANS, then EchoDor will look for a file with the
  1150.      extension of .ASC.  If that file cannot be found then EchoDor will
  1151.      look for the file name without an extension.
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.                                   Page 15
  1169.  
  1170.  
  1171. EchoDor Version 3.11
  1172. 3/16/92
  1173.  
  1174.  
  1175. Parameters
  1176.  
  1177.      All parameters in the EchoDor.Ctl file are specified as an ASCII line
  1178.      terminated with a carrage return.  Most lines (with the exception of
  1179.      the area tables and the description tables) begin with a key word
  1180.      followed by a parameter or parameters separated by spaces.  The key
  1181.      word can be upper, lower, or mixed case.  If the parameter is not a
  1182.      literal (like the origin line), the case of the parameter is also
  1183.      unimportant.
  1184.  
  1185.      Comments may be included in the control by begining a line with a semi
  1186.      colon.
  1187.  
  1188.      The last line  of the parameter file should be "--- END ---", or
  1189.      something like that.  There is a quirk in Turbo Pascal that causes the
  1190.      last line of the file to be skipped.
  1191.  
  1192.      The following is a list of all the documented parameters that can be
  1193.      used in the EchoDor.Ctl file.
  1194.  
  1195. ADDRESS zone:net/node.point
  1196.  
  1197.      This parameter should be used in place of the old ZONE, NET, NODE, and
  1198.      POINT parameters.  This is how you specify your default address.
  1199.  
  1200. AREATABLE <address>
  1201.  
  1202.      This parameter begins the area of the control file that defines each
  1203.      echo area.  Each line after this command and prior to the ENDAREATABLE
  1204.      command consists of 9 space delimited sections.  Every section is
  1205.      required.  You may enter the areas in any order you wish, when EchoDor
  1206.      checks and displays areas, it will be in the same order as you enter
  1207.      them here.  Remember:  Do not enter any spaces within the fields, if
  1208.      you do EchoDor will get confused and will not correctly read the
  1209.      table.
  1210.  
  1211.      The AREATABLE command can be followed by an address in the form
  1212.      zone:net/node.point.  This address will be the address used for all
  1213.      areas in the specified AREATABLE.  If you do not specify an address,
  1214.      you MUST have a ZONE, NET, NODE, and optionally a POINT command or an
  1215.      ADDRESS command in the file prior to the AREATABLE line.
  1216.  
  1217.      The sections are:
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.                                   Page 16
  1231.  
  1232.  
  1233. EchoDor Version 3.11
  1234. 3/16/92
  1235.  
  1236.           The number.
  1237.  
  1238.                This is the area number the user would type in to get to
  1239.                that area.  This number must be from 1-255 inclusive (you
  1240.                can use 1 or 255).  You may NOT duplicate this number on ANY
  1241.                other echo area, local area, or net mail area.
  1242.  
  1243.           The area tag.
  1244.  
  1245.                If the area you are defining is an echo, this field must
  1246.                contain the "defined" name of the echo.  You can get this
  1247.                name from your Echo Mail Coordinator.  If it is a local
  1248.                message area or net mail you may use any name you wish.
  1249.  
  1250.                DO NOT ENTER ANY SPACES in the area tag!
  1251.  
  1252.           The listed tag.
  1253.  
  1254.                This field is shown to the user in the read menu, the scan
  1255.                menu, and the new messages displays.  This field may be
  1256.                anything you wish; however, you should keep this field to
  1257.                more than about 30 characters as it may make the display of
  1258.                certain menus look strange.
  1259.  
  1260.                DO NOT ENTER ANY SPACES in the listed tag!
  1261.  
  1262.           The path.
  1263.  
  1264.                This field tells where the messages for the specific area is
  1265.                located.  Each area must be located in a different
  1266.                subdirectory.  All areas do not have to be on the same
  1267.                drive.
  1268.  
  1269.           The type echo.
  1270.  
  1271.                This field is the "T" column in the ECHODOR.CTL file.  This
  1272.                field tells the kind of message base.  The "T" column can
  1273.                have the following values:
  1274.  
  1275.                E - the area is a local echo mail message base.
  1276.  
  1277.                I - the area is national/international echo mail.
  1278.  
  1279.                N - the area is net mail.
  1280.  
  1281.                     You should normally have one per zone.
  1282.  
  1283.                B - the area is a local message or auto message area.
  1284.  
  1285.                A - the area is an auto message area (read only).
  1286.  
  1287.           The Message Type field.
  1288.  
  1289.                This field allows you to control a number of different
  1290.                attributes of the messages being entered in the area.
  1291.  
  1292.                                   Page 17
  1293.  
  1294.  
  1295. EchoDor Version 3.11
  1296. 3/16/92
  1297.  
  1298.  
  1299.                This field allows or prevents private messages in an area.
  1300.                It also controls what type of user names are placed in the
  1301.                from field.  The field can also turn on GT-Powercomm message
  1302.                code recognition. This field can contain one ore more
  1303.                characters depending on what functions are needed.
  1304.  
  1305.                If this field contains a "Y" or "P", EchoDor will ask if the
  1306.                message should be marked private.  Most echo areas, local
  1307.                and national,  DO NOT allow private messages, so the flag
  1308.                should be set to "N".  The net mail area does allow private
  1309.                messages so the flag can be set as needed.  The local
  1310.                message areas may also be set as needed.
  1311.  
  1312.                If this field contains "A", EchoDor will ask if the user
  1313.                wants to use an ALIAS.  If the user has not set up an ALIAS,
  1314.                EchoDor will tell them that they don't have an alias and it
  1315.                will tell them how to set it up.  If you enable the "A"
  1316.                option on any echo area, EchoDor will allow the user to
  1317.                enter an "A" at the user menu to allow setting the alias;
  1318.                otherwise, EchoDor will not allow the "A" at the user menu.
  1319.                If you enable both alias and private, EchoDor will allow a
  1320.                private message sent to a persons alias or real name.
  1321.  
  1322.                If this field contains a "F", EchoDor will ask if the user
  1323.                wants to send the message anonymously.  Do not mix the Y/N
  1324.                flag with the F flag.  You CAN use the F flag with the A/P
  1325.                flag.
  1326.  
  1327.                If this field contains a "G", EchoDor will honor the
  1328.                GT-Powercomm message control codes.  These codes include:
  1329.  
  1330.                     ^E - pause
  1331.                     ^R - non stop
  1332.                     ^T - no abort
  1333.  
  1334.                If you read an echo that comes from GT-NET you might want to
  1335.                enable this option.
  1336.  
  1337.           Examples:
  1338.  
  1339.                To set an area for ALIAS or anonymous, enter AF or FA in the
  1340.                field (order is not important).  Notice that there is no
  1341.                spaces between the letters.
  1342.  
  1343.                To set an area for ALIAS and PRIVATE, enter AP, PA, or AY,
  1344.                or YA (again order is not important).
  1345.  
  1346.                To just allow anonymous only, just use F.
  1347.  
  1348.           File Transfer Flag.
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.                                   Page 18
  1355.  
  1356.  
  1357. EchoDor Version 3.11
  1358. 3/16/92
  1359.  
  1360.                File transfer is available in Net Mail areas only.  If this
  1361.                flag is set to "Y", EchoDor will ask if you want to perform
  1362.                a File [A]ttach / File [R]equest when entering a message in
  1363.                the net mail area.
  1364.  
  1365.                This should be used only for net mail areas.  Putting file
  1366.                requests or file attaches into echo areas is undefined.
  1367.  
  1368.           Security.
  1369.  
  1370.                This field tells EchoDor the minimum security required to
  1371.                read messages in the area.  The specific security values are
  1372.                defined by your BBS software.  EchoDor reads the security
  1373.                value passed in the Door information file (DORINFO.DEF,
  1374.                CALLINFO.DEF, ...etc.) and compares the security passed with
  1375.                that in this field.  The security pass is less, access to
  1376.                the area will not be allowed.
  1377.  
  1378.                This field may also contain a 'Y' to indicate that it is a
  1379.                SYSOP only area.  If the user is not listed as a SYSOPNAME
  1380.                or has the SYSOP flag in the user record, the area will be
  1381.                restricted from access.
  1382.  
  1383.                The field can also contain a 'N' to indicate an open area
  1384.                which is not restricted to anyone.
  1385.  
  1386.           WRACC (Write access).
  1387.  
  1388.                This field tells EchoDor the minimum security required to
  1389.                enter messages in the area.  This field works like security
  1390.                described above.
  1391.  
  1392. CHECKDAYS <xx>
  1393.  
  1394.      This parameter is used to tell EchoDor how often the user must check
  1395.      his/her mail.  This parameter is most useful when you use the "/CHECK"
  1396.      or the "/AC" options when starting EchoDor.
  1397.  
  1398.      The day counting may be turned off by specifying a CHECKDAYS 0
  1399.      parameter.
  1400.  
  1401. CLOSINGSTRING bye bye
  1402.  
  1403.      This parameter will be displayed to the user when he/she exits EchoDor
  1404.      to return back to the BBS.  All the characters following the
  1405.      "CLOSINGSTRING" key word will be displayed.  This parameter is
  1406.      optional.
  1407.  
  1408. COMMANDSTRING <command string>
  1409.  
  1410.      Normally the main menu displayed by EchoDor is followed by "Main
  1411.      Command ? ".  This is the default value.  You can change this prompt
  1412.      by specifying the COMMANDSTRING parameter.
  1413.  
  1414.  
  1415.  
  1416.                                   Page 19
  1417.  
  1418.  
  1419. EchoDor Version 3.11
  1420. 3/16/92
  1421.  
  1422.      Anything you specify as <command str> up to 80 characters will be
  1423.      displayed to the user in place of "Main Command ? ".  A blank
  1424.      character is always appended to the end of the command string.  Do not
  1425.      enclose the <command str> in quotes or the quotes will be displayed.
  1426.  
  1427. COMMENTAREA <xx>
  1428.  
  1429.      This is the message area number as defined in the AREATABLE that will
  1430.      hold all comments to the sysop.  This parameter is not required if you
  1431.      do not enable comments.
  1432.  
  1433.      When you select an area for comments, be sure this is a local area
  1434.      (area type B).  If you choose a net mail or echo area, your mail
  1435.      packer will probably send out your comments into the net.
  1436.  
  1437. COMMENTNAME Firstname Lastname
  1438.  
  1439.      Enter the one and only name of the person who will receive comments to
  1440.      the sysop.  This parameter is not required if you do not enable
  1441.      comments.
  1442.  
  1443. COMPRESSDIR <Drive:\Directory>
  1444.  
  1445.      This command specifies the directory which is used to hold the
  1446.      compressed mail file after compression.  A full directory name can be
  1447.      used.  Drive is optional.
  1448.  
  1449.      NOTE:
  1450.  
  1451.           Don't specify any directory used by another program.
  1452.  
  1453.           The contents of the directory are erased before each compress
  1454.           operation.
  1455.  
  1456.      The directory name specified can include a single pound sign (#).
  1457.      When EchoDor reads the EchoDor.Ctl file it will replace the pound sign
  1458.      (#) with the node number specified on the command line.  This allows
  1459.      multiple directories to be used for multiple nodes.
  1460.  
  1461. COMPRESSFILE <drive:\path\file>
  1462.  
  1463.      This is the name of the file displayed to users when they select
  1464.      [C]ompress from the Pack Mail menu.  This file should list the
  1465.      compression programs that are available for compressing mail files.
  1466.      The file name should not contain an extension.  You may create up to
  1467.      three files to display to the user.  See the preceding section on
  1468.      naming files.
  1469.  
  1470. DELETEUSER <xx>
  1471.  
  1472.      This is the number of days that inactive users will remain in the
  1473.      EchoDor user file.  This parameter is only used by EchoUtil.
  1474.  
  1475.  
  1476.  
  1477.  
  1478.                                   Page 20
  1479.  
  1480.  
  1481. EchoDor Version 3.11
  1482. 3/16/92
  1483.  
  1484. DESCTABLE
  1485.  
  1486.      This area begins the description table.  This area is required only if
  1487.      there is not USERAREALIST and SYSOPAREALIST.  I suggest that you use
  1488.      this area only if you do not use the USERAREALIST and SYSOPAREALIST.
  1489.      If you use this table, it must FOLLOW the AREADESCTABLE.  After the
  1490.      DESCTABLE parameter the table has one line entries until the
  1491.      ENDDESCTABLE command.  Each line must begin with an area number.  This
  1492.      number corresponds with the area number in the AREADESCTABLE, order is
  1493.      not important.  The number must be followed by a single space.  The
  1494.      next 70 characters is the description of the area, you may enter
  1495.      anything you like, I do suggest that you enter the area name somewhere
  1496.      in the line.  See the EchoDor.Ctl file for an example.
  1497.  
  1498. DOWNLOADFILE <Drive:\Path\File>
  1499.  
  1500.      This is the name of the file displayed to users when they select
  1501.      [D]ownload from the Pack Mail menu.  This file should list the
  1502.      protocols that are available for downloading mail files.  The file
  1503.      name should not contain an extension.  You may create up to three
  1504.      files to display to the user.  See the preceding section on naming
  1505.      files.
  1506.  
  1507. DOWNLOADPROTOCOL <char> <program> <parameters>
  1508.  
  1509.      The DOWNLOADPROTOCOL parameter is required to tell EchoDor about the
  1510.      protocols that you wish to make available to users to download packed
  1511.      mail.  There must be at least one DOWNLOADPROTOCOL parameter for mail
  1512.      downloading to work.  There may be as many DOWNLOADPROTOCOL lines as
  1513.      needed.
  1514.  
  1515.      The <char> parameter tells EchoDor that character that the user will
  1516.      type in to activate the protocol.  You can use any character except an
  1517.      asterisk (*).  There is no difference in upper case and lower case
  1518.      characters.  You cannot duplicate the same character on multiple
  1519.      lines.
  1520.  
  1521.      The <program> parameter tells EchoDor what program to run.  The
  1522.      program must be specified with either the .EXE or the .COM part of the
  1523.      file name.  EchoDor will not directly run batch files; however, you
  1524.      can always run COMMAND.COM /c batch.bat to perform this operation.
  1525.      The program does not have to be specified with a path.  EchoDor will
  1526.      search the current 'path' to locate the program; but, if a path is
  1527.      specified operation will be faster.
  1528.  
  1529.      The <parameter> part of the command tells EchoDor what to pass to the
  1530.      program.  There are 4 specifications that will be replaced when the
  1531.      program is called:
  1532.  
  1533.           %1 = current node number (not usually needed)
  1534.           %2 = current com port (as a single digit)
  1535.           %3 = baud rate
  1536.           %4 = file to download (fill drive and path)
  1537.  
  1538.  
  1539.  
  1540.                                   Page 21
  1541.  
  1542.  
  1543. EchoDor Version 3.11
  1544. 3/16/92
  1545.  
  1546.      Before EchoDor calls the program, it will scan the parameter part of
  1547.      the command.  If it locates a %1, %2, %3, or a %4, it will replace
  1548.      that with the value as specified above.
  1549.  
  1550.      Examples of this command are included in "PACKMAIL.CTL".
  1551.  
  1552. ENDAREATABLE
  1553.  
  1554.      This parameter ends the area table descriptions and must be present.
  1555.      See the AREATABLE command for a description of how to create an area
  1556.      table.
  1557.  
  1558. ENDDESCTABLE
  1559.  
  1560.      This parameter end the description table section and must be present
  1561.      if a DESCTABLE is used.
  1562.  
  1563. FORUM
  1564.  
  1565.      Normally EchoDor refers to the message areas as conferences.  If your
  1566.      system uses the term "forum" you may include this word in your
  1567.      configuration file to have EchoDor refer to your areas as forums.
  1568.  
  1569. HELPFILEPREFIX <Drive:\Path\FilePrefix>
  1570.  
  1571.      This is the prefix for all help files.  The file name should not
  1572.      contain an extension.  The path is optional and if omitted, EchoDor
  1573.      will look for files in the current directory.
  1574.  
  1575. HOTKEYS
  1576.  
  1577.      When this parameter is included in the EchoDor#.Ctl file, EchoDor will
  1578.      use hot keys for all menu operations.  The user will not have to press
  1579.      the enter key.  This is included for sysops wish to have EchoDor more
  1580.      closely emulate the operation of their BBS.
  1581.  
  1582. INCLUDE <Drive:\Path\FileSpec>
  1583.  
  1584.      The INCLUDE parameter allows the sysop to tell EchoDor to read an
  1585.      additional file during startup.  This parameter is most useful for
  1586.      sysops that use multiple EchoDor#.Ctl files.  The parameters that are
  1587.      the same for each node can be placed in the "included" file.  When
  1588.      EchoDor starts it will read the EchoDor#.Ctl file as normal.  When it
  1589.      encounters the INCLUDE parameter, the specified file will be read.
  1590.      EchoDor will then complete reading the EchoDor#.Ctl file.
  1591.  
  1592. LOGFILE <Drive:\Path\File>
  1593.  
  1594.      This is the name of the file that EchoDor is to use for logging
  1595.      activity.  If the LOGFILE parameter is not specified, EchoDor will not
  1596.      do logging.
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.                                   Page 22
  1603.  
  1604.  
  1605. EchoDor Version 3.11
  1606. 3/16/92
  1607.  
  1608.      The file name specified can include a single pound sign (#).  When
  1609.      EchoDor reads the EchoDor.Ctl file it will replace the pound sign (#)
  1610.      with the node number specified on the command line.  This allows
  1611.      multiple log files to be used for multiple nodes.
  1612.  
  1613. LOGTYPE <chars>
  1614.  
  1615.      This specifies the type of logging information to be recorded.  The
  1616.      <chars> parameter contains the letter category(s) to be logged.  The
  1617.      following categories are available:
  1618.  
  1619.           : (colon)  - general information
  1620.           + (plus)   - read/scan information
  1621.           $ (dollar) - write/change/kill information
  1622.  
  1623.      Multiple categories can be specified:
  1624.  
  1625.           LOGTYPE +$
  1626.  
  1627.      If logging is enabled and the LOGTYPE parameter is not specified, full
  1628.      logging will occur.
  1629.  
  1630. MAILFILE <Drive:\Path\FileSpec>
  1631.  
  1632.      This is the file name (and path) where you wish mail packed for
  1633.      download to be placed.  It should be in a directory that the files
  1634.      section of your BBS can access or somewhere where the download
  1635.      functions can find the file.  This parameter is not required if you do
  1636.      not enable packed mail.  The drive and path are optional and if
  1637.      omitted, EchoDor will create the mail file in the current directory.
  1638.  
  1639.      EchoDor will automatically create and delete this file depending on
  1640.      the user.
  1641.  
  1642.      The file name specified can include a single pound sign (#).  When
  1643.      EchoDor reads the EchoDor.Ctl file it will replace the pound sign (#)
  1644.      with the node number specified on the command line.  This allows
  1645.      multiple mail files to be used for multiple nodes.
  1646.  
  1647. MAXLINELENGTH <xx>
  1648.  
  1649.      This parameter allows you to tell EchoDor to shorten lines.  Normally
  1650.      EchoDor sets the default line length to 75 characters.  This parameter
  1651.      allows you to adjust this maximum from 40 to 75 characters in length.
  1652.      If a value is specified that is outside that range, 75 will be used.
  1653.  
  1654.      This parameter also effects the length of lines that can be entered on
  1655.      the full screen editor.
  1656.  
  1657. MAXUSERTIME  <xx>
  1658.  
  1659.      This is the maximum session time in minutes.
  1660.  
  1661. MENU opt seclvl <Drive:\Path\FileSpec>
  1662.  
  1663.  
  1664.                                   Page 23
  1665.  
  1666.  
  1667. EchoDor Version 3.11
  1668. 3/16/92
  1669.  
  1670.      This is an enhancement to the USERAREA and SYSOPAREA files which can
  1671.      be displayed to a user.  Normally a user will select an area by
  1672.      specifying either the name or number of the desired area.  Some BBS
  1673.      system carry a large number of conferences .. too many to place on a
  1674.      single screen.
  1675.  
  1676.      The "opt" is a single letter.  Any letter except Q & L can be used.
  1677.      When that letter is selected the file specified on the MENU statement
  1678.      will be displayed to the user the security level of the user is equal
  1679.      to or greater than the specified "seclvl".
  1680.  
  1681.      The "seclvl" is the security level the user must have to access the
  1682.      area.  The user level must be equal to or greater than the level
  1683.      specified.
  1684.  
  1685.      The "FileSpec" specified should not contain an extension.  Up to three
  1686.      files may be created.  See the preceding section on file names.
  1687.  
  1688.      Using the MENU command, the areas displayed to the user may be divided
  1689.      into sections.  The individual sections are selected by a single
  1690.      letter - the "opt".  When the letter is selected the file specified
  1691.      will be displayed to the user.
  1692.  
  1693.      A specific area may be selected from ANY menu by specifying the name
  1694.      or number of the area.  Also, access to every menu is available from
  1695.      any other menu.
  1696.  
  1697. MENUFILE <Drive:\Path\File>
  1698.  
  1699.      This is the name of the main menu file.  It should not contain an
  1700.      extension. You should create 3 files for the menu.  See the preceding
  1701.      section on naming files.  The drive and path are optional and if
  1702.      omitted, EchoDor will look for the menu files in the current
  1703.      directory.
  1704.  
  1705. MONO
  1706.  
  1707.      Use this option if you are using a monochrome system but still want
  1708.      your users to see color ANSI screens on their side.
  1709.  
  1710. MSGTEXTCOLOR <xx>
  1711.  
  1712.      This is the color set when displaying or entering message text.  See
  1713.      the list of colors below.
  1714.  
  1715. NET <xx>
  1716.  
  1717.      This parameter specifies either a Fidonet NET number or a RBBSNET net
  1718.      number.
  1719.  
  1720.      This parameter MUST be specified before the first AREATABLE parameter.
  1721.  
  1722.      Don't use this parameter if your using the ADDRESS parameter.
  1723.  
  1724. NEWQUOTE
  1725.  
  1726.                                   Page 24
  1727.  
  1728.  
  1729. EchoDor Version 3.11
  1730. 3/16/92
  1731.  
  1732.  
  1733.      Starting with EchoDor v3.10 we have two methods of doing quotes in
  1734.      full screen mode.  The original method is available by default.  A
  1735.      faster method of doing quotes which will automatically insert the
  1736.      quote without the second operation is available.  To switch to this
  1737.      new method of quoting, insert the NEWQUOTE parameter in the
  1738.      EchoDor.Ctl file.
  1739.  
  1740. NOCOMMENT
  1741.  
  1742.      This option will disable the comment feature.
  1743.  
  1744. NODE <xx>
  1745.  
  1746.      This is your Fidonet or Rbbsnet node number.  It usually is between 1
  1747.      and 4 digits in length, and SHOULD NOT include a point address IE:
  1748.      (100.0) leave off the point information.
  1749.  
  1750.      EchoDor requires that the node number specified be non-zero.
  1751.  
  1752.      This parameter MUST be specified before the first AREATABLE parameter.
  1753.  
  1754.      Don't use this parameter if your using the ADDRESS parameter.
  1755.  
  1756. NODELISTPATH Type <Drive:\Path\>
  1757.  
  1758.      This tells EchoDor the subdirectory that contains the nodelist files
  1759.      and the type of nodelist file to use.
  1760.  
  1761.      Starting with EchoDor v3.10a, two types of nodelists can be used.  The
  1762.      first is a compiled version 6 nodelist files (NODELIST.DAT &
  1763.      NODELIST.NDX).  When using this set the "Type" field in the
  1764.      NODELISTPATH line to V6.  The second type of nodelist available is a
  1765.      special nodelist which is a combination of index files and the raw
  1766.      nodelist file.  The index files are created by the EchoDor nodelist
  1767.      compiler.  When using this type of nodelist specify ED as the "Type"
  1768.      field.
  1769.  
  1770.      Also, starting with EchoDor v3.10a this parameter is optional even if
  1771.      net mail is used; however, omitting this parameter will remove
  1772.      net/node number checking and verification as well as the ORIG/DEST
  1773.      lines while reading net mail.
  1774.  
  1775. NOIGNORE
  1776.  
  1777.      This will disable the ignore command.  The ignore command is used to
  1778.      exclude certain areas from the message check.  This is useful if you
  1779.      have a lot of echoes, and checking them all would take a very long
  1780.      time.
  1781.  
  1782. NOPACKMAIL
  1783.  
  1784.      This disables the pack mail feature.  If you do not include this
  1785.      command then the "MAILFILE" command is required.
  1786.  
  1787.  
  1788.                                   Page 25
  1789.  
  1790.  
  1791. EchoDor Version 3.11
  1792. 3/16/92
  1793.  
  1794. NOSETNATIONAL
  1795.  
  1796.      By default, EchoDor will set everyones ignore status to ignore
  1797.      national echoes.  This option will set All echoes to be checked.
  1798.  
  1799. NOTAVAIL <Drive:\Path\FileSpec>
  1800.  
  1801.      If specified, this file will be displayed to users that try to access
  1802.      an area which they don't have access to because of security.  If this
  1803.      parameter is not specified, the system will issue an access not
  1804.      allowed type message.  The drive and path are optional.  If not
  1805.      specified EchoDor will look in the current directory for the file.
  1806.  
  1807. NOWRITE <Drive:\Path\File>
  1808.  
  1809.      If specified, this file will be displayed to users that try to enter a
  1810.      message into an area for which they do not have write access.  If this
  1811.      parameter is not specified, the system will issue an access not
  1812.      allowed type message.  The drive and path are optional.  If not
  1813.      specified EchoDor will look in the current directory for the file.
  1814.  
  1815. NUMHELPFILES <xx>
  1816.  
  1817.      This is the number of help files (Not including the menu!).
  1818.  
  1819. ORIGIN your origin line from your Areas.BBS file
  1820.  
  1821.      This is the origin line that will be appended to all messages entered
  1822.      with EchoDor.  It should look the same as the one in your AREAS.BBS
  1823.      file (part of the echo mail system).  Do not include your net/node
  1824.      number in your origin line.  Versions of EchoDor later than 3.00 will
  1825.      append your net node number to the end of your origin line.
  1826.  
  1827.      If you want an area to have different origin line from the one
  1828.      specified in the ORIGIN parameter, create a file called ORIGIN in that
  1829.      message area.  Put one line in this file, do not include your net/node
  1830.      number on the line.  When EchoDor saves your message it will check for
  1831.      this file.  If it finds one it will use the first line of the file to
  1832.      replace the ORIGIN line specified here.  You do not have to have an
  1833.      ORIGIN file in every area, if the ORIGIN file does not exist in some
  1834.      areas, EchoDor will use the ORIGIN line specified in this parameter.
  1835.  
  1836. OUTBOUND <Drive:\Path>
  1837.  
  1838.      This is the full drive and path of your outbound directory.  The drive
  1839.      and path are required.  This parameter is only used by EchoUtil for
  1840.      tasks such as REQFILE, SENDFILE, ATTLIST.
  1841.  
  1842. PACKERPROGRAM  <char> <program> <parameters>
  1843.  
  1844.      The PACKERPROGRAM parameter is required to tell EchoDor about the
  1845.      archiving programs that you wish to make available to the users to
  1846.      compress mail.  There must be at least one PACKERPROGRAM parameter for
  1847.      the [C]ompress option to work.  There may be as many PACKERPROGRAM
  1848.      lines as needed.
  1849.  
  1850.                                   Page 26
  1851.  
  1852.  
  1853. EchoDor Version 3.11
  1854. 3/16/92
  1855.  
  1856.  
  1857.      The <char> parameter tells EchoDor what character that the user will
  1858.      type in to activate the archive program.  You can use any character
  1859.      except asterisk (*).  There is no difference between upper case and
  1860.      lower case characters.  You cannot duplicate the same character on
  1861.      multiple lines.
  1862.  
  1863.      The <program> parameter tells EchoDor what program to run.  The
  1864.      program must be specified with either the .EXE or the .COM included as
  1865.      part of the program name.  EchoDor cannot run batch files; however,
  1866.      you can always run:
  1867.  
  1868.           COMMAND.COM /c batch.bat
  1869.  
  1870.      to perform this operation.  The program does not have to be specified
  1871.      with a path.  EchoDor will search the current 'path' to locate the
  1872.      program; but, if the path is specified operation will be faster.
  1873.  
  1874.      The <parameter> part of the command tells EchoDor what to pass to the
  1875.      program.  There are 2 specifications that will be replaced when the
  1876.      program is called:
  1877.  
  1878.           %1 = name of the file to compress. (includes drive and path).
  1879.  
  1880.           %2 = directory where to place the compressed file.
  1881.  
  1882.      Before EchoDor calls the specified program, it will scan the parameter
  1883.      part of the command.  If it locates a %1 or %2, it will replace that
  1884.      with the value as specified above.
  1885.  
  1886. PACKMENUFILE <drive:\path\file>
  1887.  
  1888.      This is the name of the pack menu file.  This file is displayed to the
  1889.      user when the [P] command on the main menu is selected.  It should not
  1890.      contain an extension. You should create 3 files for the menu.  See the
  1891.      preceding section on naming files.  The drive and path are optional
  1892.      and if omitted, EchoDor will look for the menu files in the current
  1893.      directory.
  1894.  
  1895.      You should include the following options on the menu:
  1896.  
  1897.                [A] - Area Change or [J] - Join area
  1898.                [B] - Set read criteria
  1899.                [I] - Personal Mail Setup
  1900.                [K] - Kill pack mail file
  1901.                [P] - Pack Mail for download
  1902.                [C] - Compress Packed Mail
  1903.                [D] - Download Packed Mail
  1904.                [Q] - Quit to main menu
  1905.  
  1906.  
  1907. PACKMAILTEXT <drive:\path\file>
  1908.  
  1909.  
  1910.  
  1911.  
  1912.                                   Page 27
  1913.  
  1914.  
  1915. EchoDor Version 3.11
  1916. 3/16/92
  1917.  
  1918.      The file on this line will be displayed to any user that has caused a
  1919.      pack mail to be generated. This is usually used to tell the user where
  1920.      to find the mail file, for example:
  1921.  
  1922.      Your mail is packed ... you may download using [D].
  1923.  
  1924. POINT <xx>
  1925.  
  1926.      This parameter specifies the POINT part of your net node number.
  1927.      EchoDor does not currently provide point remapping; however, this
  1928.      value is placed in the ORIGIN line to complete the net node number.
  1929.  
  1930.      This parameter if used MUST be specified before the first AREATABLE
  1931.      command.
  1932.  
  1933.      Don't use this parameter if your using the ADDRESS parameter.
  1934.  
  1935. READHELPFILE <drive:\path\file>
  1936.  
  1937.      This specifies the name of the help file which is displayed to the
  1938.      user when a question mark (?) is entered at the read menu.
  1939.  
  1940. SCANBARCOLOR <xx>
  1941.  
  1942.      This is the color set on the top line of the scan message display.
  1943.  
  1944. SCANLINECOLOR <xx>
  1945.  
  1946.      This is the color set for each line displayed after the scan bar line
  1947.      during the Scan Messages function.
  1948.  
  1949. SCANLOGNAME <Drive:\Path\FileSpec>
  1950.  
  1951.      This tells EchoDor the full path name where the scan log file should
  1952.      be written.  This file is used by programs such as QM or ConfMail to
  1953.      specify the echo mail areas which contain new messages.  This file
  1954.      will only be written when a user enters a message into an echo mail or
  1955.      net mail area.  The drive and path are optional and if omitted,
  1956.      EchoDor will create the scan log file in the current directory.
  1957.  
  1958.      Note:
  1959.           After mail is scanned by a mail scanner program (such as QM or
  1960.           ConfMail) this file MUST BE DELETED.  Because a user may go in
  1961.           and out of EchoDor numerous times during a session, EchoDor will
  1962.           not delete this file but will read it in and append new areas to
  1963.           it.
  1964.  
  1965.      The file name specified can include a single pound sign (#).  When
  1966.      EchoDor reads the EchoDor.Ctl file it will replace the pound sign (#)
  1967.      with the node number specified on the command line.  This allows
  1968.      multiple scan log files to be used for multiple nodes.
  1969.  
  1970. SYSOPAREALIST <Drive:\Path\FileSpec>
  1971.  
  1972.  
  1973.  
  1974.                                   Page 28
  1975.  
  1976.  
  1977. EchoDor Version 3.11
  1978. 3/16/92
  1979.  
  1980.      This is the file displayed to the SYSOP when the L)ist areas function
  1981.      is selected.  See the above description on naming files.  This
  1982.      parameter is required if you do not use the AREADESC.  The drive and
  1983.      path are optional.
  1984.  
  1985. UPLOADDIR <Drive:\Directory>
  1986.  
  1987.      This command specifies the directory which will hold the uploaded file
  1988.      after completing a mail upload.  A full directory name can be used.
  1989.      Drive is optional.
  1990.  
  1991.      Note:
  1992.           Don't specify any directory used by any other program.  The
  1993.           contents of this directory is erased before each upload
  1994.           operation.
  1995.  
  1996.      The directory name specified can include a single pound sign (#).
  1997.      When EchoDor reads the EchoDor.Ctl file it will replace the pound sign
  1998.      (#) with the node number specified on the command line.  This allows
  1999.      multiple directories to be used for multiple nodes.
  2000.  
  2001. UPLOADFILE <Drive:\Path\File>
  2002.  
  2003.      This is the name of the file displayed to users when they answer Y to
  2004.      the "Do you want to up load a message" question.  This file should
  2005.      list the up load protocols that are available.  The file name should
  2006.      not contain any extension.  You may create up to three files to
  2007.      display to the user.  See the preceding section on naming files.
  2008.  
  2009. UPLOADPROTOCOL <char> <program> <parameter>
  2010.  
  2011.      The UPLOADPROTOCOL parameter is required to tell EchoDor about the
  2012.      protocols that you wish to make available to users to up load
  2013.      messages.  There must be at least one UPLOADPROTOCOL parameter for
  2014.      message up loading to work.  There may be as many UPLOADPROTOCOL lines
  2015.      as needed.
  2016.  
  2017.      The <char> parameter tells EchoDor that character that the user will
  2018.      type in to activate the protocol.  You can use any character except an
  2019.      asterisk (*).  There is no difference in upper case and lower case
  2020.      characters.  You cannot duplicate the same character on multiple
  2021.      lines.
  2022.  
  2023.      The <program> parameter tells EchoDor what program to run.  The
  2024.      program must be specified with either the .EXE or the .COM part of the
  2025.      file name.  EchoDor will not directly run batch files; however, you
  2026.      can always run COMMAND.COM /c batch.bat to perform this operation.
  2027.      The program does not have to be specified with a path.  EchoDor will
  2028.      search the current 'path' to locate the program; but, if a path is
  2029.      specified operation will be faster.
  2030.  
  2031.      The <parameter> part of the command tells EchoDor what to pass to the
  2032.      program.  There are 4 specifications that will be replaced when the
  2033.      program is called:
  2034.  
  2035.  
  2036.                                   Page 29
  2037.  
  2038.  
  2039. EchoDor Version 3.11
  2040. 3/16/92
  2041.  
  2042.           %1 = current node number (not usually needed)
  2043.           %2 = current com port (as a single digit)
  2044.           %3 = baud rate
  2045.           %4 = up load directory (as specified in EchoDor.Ctl)
  2046.  
  2047.      Before EchoDor calls the program, it will scan the parameter part of
  2048.      the command.  If it locates a %1, %2, %3, or a %4, it will replace
  2049.      that with the value as specified above.
  2050.  
  2051.      Before the up load is started, EchoDor will switch to the up load
  2052.      directory and make the specified drive the default drive.  This will
  2053.      allow you to use DSZ and not have to worry about specifying the place
  2054.      to put the file.  After the up load completes, EchoDor will switch
  2055.      back to it's start up directory and drive.
  2056.  
  2057.      You don't have to worry about the name of the file that is uploaded.
  2058.      EchoDor will import every file that it finds in the up load directory.
  2059.  
  2060. USERAREALIST <Drive:\Path\File>
  2061.  
  2062.      This is the file displayed to the user when the L)ist areas function
  2063.      is selected.  See the above description on naming files.  This
  2064.      parameter is required if you do not use the AREADESC.  The drive and
  2065.      path are optional.
  2066.  
  2067. USERFILE <Drive:\Path\FileSpec>
  2068.  
  2069.      This is the name of the user file maintained by EchoDor.  If this
  2070.      parameter is not specified the default will be EchoUser.BBS in the
  2071.      current directory.
  2072.  
  2073.      Note:
  2074.           This parameter is required when running a multi-node system.  All
  2075.           copies of EchoDor must share the same USERFILE.
  2076.  
  2077. VISUALESC <char>
  2078.  
  2079.      This option tells EchoDor to allow these characters to represent the
  2080.      <ESC> character when entered on the first character of a line when in
  2081.      the visual editor.  A lot of people are used to entering .S or /S as
  2082.      the first characters of a line when they want to save the message.  If
  2083.      you set this parameter something like:
  2084.  
  2085.           VISUALESC ./\
  2086.  
  2087.      Then if the user enters any of the three characters (period, back
  2088.      slash, or slash) as the first character of a line, Visual Editor will
  2089.      react as if the user pressed the <ESC> key.  So if the user types .S
  2090.      the message will be saved.  This is a nice feature to have an users
  2091.      will appreciate it.
  2092.  
  2093. WELCOME <Drive:\Path\FileSpec>
  2094.  
  2095.  
  2096.  
  2097.  
  2098.                                   Page 30
  2099.  
  2100.  
  2101. EchoDor Version 3.11
  2102. 3/16/92
  2103.  
  2104.      This is the name of the welcome file that is to be displayed each time
  2105.      a user accesses the echo mail door.  See the above description on
  2106.      naming files.  The drive and path are optional.
  2107.  
  2108.      If you do not wish to have a welcome file displayed to the user then
  2109.      remove this command.
  2110.  
  2111. ZONE <xx>
  2112.  
  2113.      This parameter specifies you ZONE part of your net node number.  For
  2114.      Fidonet boards running in the US, this will be 1, for Rbbsnet boards
  2115.      running in the US, this will be 8.
  2116.  
  2117.      This parameter MUST be specified before the AREATABLE command in the
  2118.      control file.
  2119.  
  2120.      Don't use this parameter if your using the ADDRESS parameter.
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.                                   Page 31
  2161.  
  2162.  
  2163. EchoDor Version 3.11
  2164. 3/16/92
  2165.  
  2166.  
  2167. Color Table
  2168.  
  2169. The follow colors may be used for both background colors and foreground
  2170. colors:
  2171.  
  2172. 0 - Black
  2173. 1 - Blue
  2174. 2 - Green
  2175. 3 - Cyan
  2176. 4 - Red
  2177. 5 - Magenta
  2178. 6 - Brown
  2179. 7 - Light Gray
  2180.  
  2181. The following colors may be used only for foreground colors:
  2182.  
  2183.  8 - Dark Gray
  2184.  9 - Light Blue
  2185. 10 - Light Green
  2186. 11 - Light Cyan
  2187. 12 - Light Red
  2188. 13 - Light Magenta
  2189. 14 - Yellow
  2190. 15 - White
  2191.  
  2192. Some parameters allow you to specify both a foreground and a background
  2193. color; however, you must specify it in a single number (the parameter
  2194. PROMPTCOLOR is an example of this).  To figure the number you want:
  2195.  
  2196. First pick out your background color and multiply that number by 16.  Then
  2197. add your foreground color.  For a background of red and a foreground of
  2198. white.
  2199.  
  2200. Red = 4.
  2201. 4 x 16 = 64.
  2202. White = 15.
  2203. 64 + 15 = 79.
  2204.  
  2205. Therefore the number you specify is 79.
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.                                   Page 32
  2223.  
  2224.  
  2225. EchoDor Version 3.11
  2226. 3/16/92
  2227.  
  2228.  
  2229. SYSOP setup
  2230.  
  2231. Every system has a SYSOP.  This is the person that is responsible for the
  2232. operation of the BBS.  Other people may also be required to assist in the
  2233. SYSOP functions, so a BBS may have multiple people that have SYSOP or
  2234. assistant SYSOP access.
  2235.  
  2236. The EchoDor system supports as many Sysops as needed.  When first setting
  2237. up EchoDor you must tell EchoDor that you are the SYSOP.  First you must
  2238. log into EchoDor, if you are just setting up EchoDor you should have
  2239. already logged into the system once to check it.  If you have not already
  2240. done so, start EchoDor.  This will put your name into the EchoDor users
  2241. file.
  2242.  
  2243. EchoDor /s
  2244.  
  2245. The '/s' tells EchoDor that you are performing a "fast logon as sysop".
  2246. Now exit EchoDor.
  2247.  
  2248. You now need to start EchoUser.  Do this as:
  2249.  
  2250. EchoUser /s
  2251.  
  2252. Now select yourself as the record to update.  Use the [U] function and
  2253. enter your name as you typed it in the DoorDriv.Ctl file.  You should be
  2254. presented with a list of users (possibly only 1).  Enter the number
  2255. displayed to the left of the name.  EchoUser will then display you as the
  2256. user.  This is the record that will be effected by the changes you are
  2257. about to make.
  2258.  
  2259. Now select [S]ysop flag.  The program will tell you that the flag is either
  2260. off or on and will ask if you want to change it.  If it says OFF, answer Y
  2261. when it asks if you want to turn the flag on.  It will then tell you that
  2262. the user is now a SYSOP.  If you need the menu back, just press enter.
  2263.  
  2264. With some systems (Wildcat! being one of them) it may be necessary to set
  2265. the SYSOP security level.  When you log on the system locally (using /L or
  2266. /S), EchoDor sets the security level to 1024.  This may not be high enough
  2267. for some systems.  If you need to have a higher security level select
  2268. [L]evel from the menu.  EchoUser will probably tell you that the user uses
  2269. the level from the BBS (you'll want this for most users).  For yourself,
  2270. set the security level that you need as SYSOP.  When you set a security
  2271. level in this way, that will be the security level that you will receive
  2272. every time you enter EchoDor, either locally or through the BBS.
  2273.  
  2274. You can repeat this for every user that you want to setup as a sysop.
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.                                   Page 33
  2285.  
  2286.  
  2287. EchoDor Version 3.11
  2288. 3/16/92
  2289.  
  2290.  
  2291. Pack Mail / Compress / Download Setup
  2292.  
  2293. A user may now pack mail, compress and then download this mail packet with
  2294. EchoDor.  To fully implement these features you must make modifications in
  2295. the ECHODOR.CTL file.  Older versions of EchoDor also required
  2296. modifications of the EchoDor batch file, this need has been eliminated.
  2297.  
  2298. All compression is performed by external archiving programs.  The mail file
  2299. name containing the text is passed as one of the parameters to the
  2300. compression program.  A second parameter specifies the directory where the
  2301. compressed file should be placed.  The specific name of the compressed file
  2302. is not important as EchoDor will transfer any file it finds in that
  2303. directory to the user (you can even put advertisements into the directory).
  2304.  
  2305. All downloads are implemented with external protocols.  One of the most
  2306. popular is DSZ.  The included batch files give examples using DSZ for X, Y,
  2307. and Z modem.  Note that DSZ is a shareware program.  Registering EchoDor
  2308. does not give you the right to use DSZ.  You should register that program
  2309. also.
  2310.  
  2311. Basic Setup
  2312.  
  2313. To implement Pack Mail you must include the following commands in the
  2314. EchoDor.Ctl file:
  2315.  
  2316.      PACKMENU
  2317.  
  2318.           This command tells EchoDor where to find the PACKMENU files to be
  2319.           displayed to the user when he/she selects [P]ack Mail from the
  2320.           main menu.
  2321.  
  2322.           You should include the following options on the menu:
  2323.  
  2324.                [A] - Area Change or [J] - Join area
  2325.                [B] - Set read criteria
  2326.                [I] - Personal Mail Setup
  2327.                [K] - Kill pack mail file
  2328.                [P] - Pack Mail for download
  2329.                [C] - Compress Packed Mail
  2330.                [D] - Download Packed Mail
  2331.                [Q] - Quit to main menu
  2332.  
  2333.      PACKMAILTEXT
  2334.  
  2335.           This command tells EchoDor the name of the file to display to the
  2336.           user when he/she has complete packing mail.  This file might say
  2337.           something like:
  2338.  
  2339.           Your mail is packed.  You may download using [D].
  2340.  
  2341.      MAILFILE
  2342.  
  2343.  
  2344.  
  2345.  
  2346.                                   Page 34
  2347.  
  2348.  
  2349. EchoDor Version 3.11
  2350. 3/16/92
  2351.  
  2352.           This command tells EchoDor the name to use for the file created
  2353.           that contains the packed mail.  This file name can include a full
  2354.           drive, path, and file specification.
  2355.  
  2356.           Don't put this file into the compress or download directory.
  2357.  
  2358.           Note:
  2359.                If you run multiple nodes, this file must be different for
  2360.                each node.
  2361.  
  2362.                This difference may come by being in different default
  2363.                directories or by using a different name in the different
  2364.                EchoDor#.Ctl files.
  2365.  
  2366.                You can also make the files different by including a pound
  2367.                symbol (#) in the file name.  When EchoDor starts, it will
  2368.                replace the pound symbol (#) with the current node number.
  2369.  
  2370.                If you only run a single node, this file may be anything you
  2371.                want.
  2372.  
  2373. You must also make sure that the NOPACKMAIL command in the EchoDor.Ctl file
  2374. is commented out or removed.
  2375.  
  2376. Compressing Mail
  2377.  
  2378. To implement the mail compress feature of EchoDor, you must include the
  2379. following additional parameters in the EchoDor.Ctl file.
  2380.  
  2381.      COMPRESSFILE <filename>
  2382.  
  2383.           This contains the name of the file to display to the user when
  2384.           [C]ompress is selected from the pack mail menu file.  The file
  2385.           should contain a list of the available archive programs that can
  2386.           be used to compress the mail file.
  2387.  
  2388.      COMPRESSDIR <Drive:\Path>
  2389.  
  2390.           This command specifies the directory which will be used by the
  2391.           compress program to hold the compressed mail file.  This file is
  2392.           checked by EchoDor during download to figure out of the user
  2393.           wants to download compressed mail or uncompressed mail.
  2394.  
  2395.           NOTE:
  2396.                DO NOT USE THIS DIRECTORY FOR ANYTHING ELSE !!!!
  2397.  
  2398.           This directory is completely erased by EchoDor each time a new
  2399.           user logs into the system.
  2400.  
  2401.      PACKERPROGRAM  <char> <program> <parameters>
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.                                   Page 35
  2409.  
  2410.  
  2411. EchoDor Version 3.11
  2412. 3/16/92
  2413.  
  2414.           The PACKERPROGRAM parameter is required to tell EchoDor about the
  2415.           archiving programs that you wish to make available to the users
  2416.           to compress mail.  There must be at least one PACKERPROGRAM
  2417.           parameter for the [C]ompress option to work.  There may be as
  2418.           many PACKERPROGRAM lines as needed.
  2419.  
  2420.           The <char> parameter tells EchoDor what character that the user
  2421.           will type in to activate the archive program.  You can use any
  2422.           character except asterisk (*).  There is no difference between
  2423.           upper case and lower case characters.  You cannot duplicate the
  2424.           same character on multiple lines.
  2425.  
  2426.           The <program> parameter tells EchoDor what program to run.  The
  2427.           program must be specified with either the .EXE or the .COM
  2428.           included as part of the program name.  EchoDor cannot run batch
  2429.           files; however, you can always run:
  2430.  
  2431.                COMMAND.COM /c batch.bat
  2432.  
  2433.           to perform this operation.  The program does not have to be
  2434.           specified with a path.  EchoDor will search the current 'path' to
  2435.           locate the program; but, if the path is specified operation will
  2436.           be faster.
  2437.  
  2438.           The <parameter> part of the command tells EchoDor what to pass to
  2439.           the program.  There are 2 specifications that will be replaced
  2440.           when the program is called:
  2441.  
  2442.                %1 = name of the file to compress. (includes drive and
  2443.                     path).
  2444.  
  2445.                %2 = directory where to place the compressed file.
  2446.  
  2447.           Before EchoDor calls the specified program, it will scan the
  2448.           parameter part of the command.  If it locates a %1 or %2, it will
  2449.           replace that with the value as specified above.
  2450.  
  2451.  
  2452. Downloading Mail
  2453.  
  2454. To implement the downloading feature of EchoDor, you must include the
  2455. following additional parameters in the EchoDor.Ctl file:
  2456.  
  2457.      DOWNLOADFILE <filename>
  2458.  
  2459.           This contains the name of the file to display to the user when
  2460.           [D]ownload is selected from the pack mail menu file.  The file
  2461.           should contain a list of the available protocols that can be used
  2462.           to download.
  2463.  
  2464.      DOWNLOADPROTOCOL <char> <program> <parameters>
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.                                   Page 36
  2471.  
  2472.  
  2473. EchoDor Version 3.11
  2474. 3/16/92
  2475.  
  2476.           The DOWNLOADPROTOCOL parameter is required to tell EchoDor about
  2477.           the protocols that you wish to make available to users to
  2478.           download packed mail.  There must be at least one
  2479.           DOWNLOADPROTOCOL parameter for mail downloading to work.  There
  2480.           may be as many DOWNLOADPROTOCOL lines as needed.
  2481.  
  2482.           The <char> parameter tells EchoDor that character that the user
  2483.           will type in to activate the protocol.  You can use any character
  2484.           except an asterisk (*).  There is no difference in upper case and
  2485.           lower case characters.  You cannot duplicate the same character
  2486.           on multiple lines.
  2487.  
  2488.           The <program> parameter tells EchoDor what program to run.  The
  2489.           program must be specified with either the .EXE or the .COM part
  2490.           of the file name.  EchoDor will not directly run batch files;
  2491.           however, you can always run COMMAND.COM /c batch.bat to perform
  2492.           this operation.  The program does not have to be specified with a
  2493.           path.  EchoDor will search the current 'path' to locate the
  2494.           program; but, if a path is specified operation will be faster.
  2495.  
  2496.           The <parameter> part of the command tells EchoDor what to pass to
  2497.           the program.  There are 4 specifications that will be replaced
  2498.           when the program is called:
  2499.  
  2500.                %1 = current node number (not usually needed)
  2501.                %2 = current com port (as a single digit)
  2502.                %3 = baud rate
  2503.                %4 = file to download (full drive and path)
  2504.  
  2505.           Before EchoDor calls the program, it will scan the parameter part
  2506.           of the command.  If it locates a %1, %2, %3, or a %4, it will
  2507.           replace that with the value as specified above.
  2508.  
  2509.           Don't worry about trying to decide if to download a compress file
  2510.           or a plain text file, EchoDor will make the selection and pass
  2511.           the correct file name.
  2512.  
  2513.           Examples of this command are included in "PACKMAIL.CTL".
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.                                   Page 37
  2533.  
  2534.  
  2535. EchoDor Version 3.11
  2536. 3/16/92
  2537.  
  2538.  
  2539. Multiple Node Setup
  2540.  
  2541.      Another name for a multiple node setup is a multiple line setup.
  2542.      EchoDor has always supported multiple nodes.  However, with the
  2543.      additional options that are available and the somewhat varied systems
  2544.      supported, I thought a separate section explaining methods to be used
  2545.      to setup a multiple node system would be in order.
  2546.  
  2547.      There are two basic ways to set up EchoDor for multiple node
  2548.      operation.  The first way is the "common directory" method.  Using
  2549.      this method, all the EchoDor files are in a single directory and node
  2550.      numbers are used to differentiate between users on the different
  2551.      nodes.  The second way is to use a separate directory for each node
  2552.      you plan to run.  This operation uses the "default" directory to keep
  2553.      multiple users separate.  Depending on the way you run your board and
  2554.      the BBS software you use will make one of the two methods most
  2555.      effective for your operation.  The following sections explain how to
  2556.      set up each of the two methods and suggestions for when to use it.
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.                                   Page 38
  2595.  
  2596.  
  2597. EchoDor Version 3.11
  2598. 3/16/92
  2599.  
  2600. The Common Directory Method
  2601.  
  2602. The common directory method places all the EchoDor files into a single
  2603. directory.  EchoDor is then started with a different node number for each
  2604. node.  This method is most effective when using BBS systems that run
  2605. multiple nodes using node numbers and creates door information files with
  2606. different names for each node (such as RBBS).
  2607.  
  2608. How to set up the "common directory" system:
  2609.  
  2610. 1.   Create a directory to hold all the EchoDor files.  This is the same
  2611.      way you would set up EchoDor for a single node system.  We will call
  2612.      this the EchoDor Main Directory.  EchoDor will never change
  2613.      directories during it's operation.
  2614.  
  2615.      You must make sure that the ECHODNLD & ECHOCMPS batch files don't
  2616.      change directories either, watch out for download protocol programs
  2617.      and compress programs that change the directory without you telling
  2618.      them.
  2619.  
  2620. 2.   If you intend to use the COMPRESS feature in EchoDor set up a separate
  2621.      subdirectory within the EchoDor Main Directory for each node.  Use
  2622.      names something like this:
  2623.  
  2624.           COMPRES0  -    local use
  2625.           COMPRES1  -    Node 1 use
  2626.           COMPRES2  -    Node 2 use
  2627.                .
  2628.                .
  2629.           COMPRES9  -    Node 9 use
  2630.  
  2631. 3.   Make the following changes to your EchoDor.Ctl file:
  2632.  
  2633.      a.   If you use the SCANLOGNAME command, change it to something like:
  2634.  
  2635.           SCANLOGNAME EchoDor\Scan#.Log
  2636.  
  2637.           Notice the '#' in the name.  This will be replaced with the node
  2638.           number you use to start EchoDor.
  2639.  
  2640.      b.   If you are using the mail file features of EchoDor (which is
  2641.           always used with COMPRESS & DOWNLOAD) you must change the
  2642.           MAILFILE command to something like this:
  2643.  
  2644.           MAILFILE Mail#.Txt
  2645.  
  2646.           Notice the '#' in the name.  This will be replaced with the node
  2647.           number you use to start EchoDor.
  2648.  
  2649.      c.   If you are using the mail compress feature of EchoDor you will
  2650.           need to change the COMPRESSDIR command to something like:
  2651.  
  2652.           COMPRESSDIR COMPRES#
  2653.  
  2654.  
  2655.  
  2656.                                   Page 39
  2657.  
  2658.  
  2659. EchoDor Version 3.11
  2660. 3/16/92
  2661.  
  2662.           Notice the '#' in the directory name.  This is replaced with the
  2663.           node number you use to start EchoDor.  The "COMPRES#" name will
  2664.           be changed to names like "COMPRES0", "COMPRES1", and so on.  The
  2665.           names must match the directories you created in the above
  2666.           section.
  2667.  
  2668. 4.   Also, you will have to make your batch files that control scanning the
  2669.      mail after it is entered aware of the log names.  In place of making a
  2670.      very complex batch file to decide which log to pass to your mail
  2671.      packer, you can use SCANMRG to combine the various scan logs into a
  2672.      single log, then perform a single scan once a day.  To perform this
  2673.      operation you would add a command such as:
  2674.  
  2675.           SCANMRG EchoDor\Scan%1.Log EchoDor\ScanLog.Log
  2676.  
  2677.      This command goes in your EchoDor.Bat file after the IF ERRORLEVEL 3
  2678.      line.  This would combine all the Scanlogs for the various nodes into
  2679.      a single ScanLog.  An explanation of SCANMRG is in sections that
  2680.      follow.  You should not replace the SCANMRG with a copy/append command
  2681.      as the operation of SCANMRG is different.
  2682.  
  2683. 5.   If the various nodes in your system need other changes in the
  2684.      EchoDor.Ctl file for reasons such as different echos, different
  2685.      privileges or other such reasons, EchoDor allows you to create a
  2686.      separate EchoDor.Ctl file for each node.  The specific file used is
  2687.      created by changing the name of the base file:
  2688.  
  2689.           EchoDor.Ctl - this is the default file
  2690.           EchoDor0.Ctl - this would be used for local operation
  2691.           EchoDor1.Ctl - this would be used for node 1
  2692.           EchoDor2.Ctl - this would be used for node 2
  2693.                .
  2694.                .
  2695.           EchoDor9.Ctl - this would be used for node 9
  2696.  
  2697.      You should still make the changes outlined above in the EchoDor.Ctl
  2698.      file before you make copies of it for the various nodes.  This will
  2699.      help prevent errors when you create the EchoDor#.Ctl files for the
  2700.      various nodes.
  2701.  
  2702.      Also, be sure the EchoDor.Ctl file contains EVERY message are you
  2703.      intend to carry.  This is the file used by EchoUtil when performing
  2704.      maintenance.
  2705.  
  2706.      Finally, be aware that should a node look for it's EchoDo#.Ctl file
  2707.      and one is not present, EchoDor will use the default (EchoDor.Ctl)
  2708.      file.
  2709.  
  2710. 6.   If the various nodes in your system require different information in
  2711.      the DoorDriv.Ctl file, such as for different types of modems or
  2712.      different BBS names or different SYSOP names, EchoDor allows multiple
  2713.      DoorDriv.Ctl files to be used for each node.  The specific file used
  2714.      is created by changing the name of the base file:
  2715.  
  2716.           DoorDriv.Ctl - this is the default file
  2717.  
  2718.                                   Page 40
  2719.  
  2720.  
  2721. EchoDor Version 3.11
  2722. 3/16/92
  2723.  
  2724.           DoorDri0.Ctl - this is used for local operation
  2725.           DoorDri1.Ctl - this is used for node 1
  2726.           DoorDri2.Ctl - this is used for node 2
  2727.                .
  2728.                .
  2729.           DoorDri9.Ctl - this is used for node 9
  2730.  
  2731.      If EchoDor looks for it's DoorDri#.Ctl file and cannot find it, it
  2732.      will use the default (DoorDriv.Ctl) file.
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.                                   Page 41
  2781.  
  2782.  
  2783. EchoDor Version 3.11
  2784. 3/16/92
  2785.  
  2786. Multiple Directory Method
  2787.  
  2788. The multiple directory method sets up a single directory to hold all the
  2789. "common" EchoDor files and separate directories for the "node specific"
  2790. files.  This method is most effective when used with BBS systems that do
  2791. not provide "node number" information and always names the door information
  2792. file the same (such as WildCat!).
  2793.  
  2794. To set  up a "multiple directory" system do the following:
  2795.  
  2796. 1.   Create a "common" directory which will be shared between all the nodes
  2797.      in the system.  Put the following files in this directory (check your
  2798.      EchoDor.Ctl file for the exact names):
  2799.  
  2800.           EchoUser.BBS - this is the main user file
  2801.           The MENUFILE files (used for the main menu)
  2802.           The PACKMENUFILE files (used for the pack menu)
  2803.           The USERAREALIST files (conference lists)
  2804.           The SYSOPAREALIST files (sysop conference list)
  2805.           The MENU files (conference menu files)
  2806.           The help files
  2807.           The DOWNLOADFILE
  2808.           The COMPRESSFILE
  2809.           The NOTAVAIL file
  2810.           The NOWRITE file
  2811.           The PACKMAILTEXT file
  2812.           The WELCOME files
  2813.  
  2814.      Also, put a copy of the DoorDriv.Ctl & EchoDor.Ctl file into this
  2815.      directory.  We will use the files in the "common" directory to make a
  2816.      model for all the other directories.
  2817.  
  2818. 2.   Now we will edit the EchoDor.Ctl file that we have placed in the
  2819.      common directory.  The following lines should be changed to include a
  2820.      full drive, path, and file name so that the various nodes can find
  2821.      these files:
  2822.  
  2823.           USERFILE <drive:\path\file>
  2824.  
  2825.      This is probably the most important line in the EchoDor.Ctl file when
  2826.      using multiple node / multiple directory setups.  This tells EchoDor
  2827.      where to find the main user file.  Be sure to specify a full drive,
  2828.      path, and file name in this line.  This will cause EchoDor to share
  2829.      the file between nodes.
  2830.  
  2831.           MENUFILE
  2832.           PACKMENUFILE
  2833.           USERAREALIST
  2834.           SYSOPAREALIST
  2835.           NOWRITE
  2836.           NOTAVAIL
  2837.           HELPFILEPREFIX
  2838.           MENU
  2839.           DOWNLOADFILE
  2840.           COMPRESSFILE
  2841.  
  2842.                                   Page 42
  2843.  
  2844.  
  2845. EchoDor Version 3.11
  2846. 3/16/92
  2847.  
  2848.           PACKMAILTEXT
  2849.           WELCOME
  2850.  
  2851.      Now we are going to edit the lines which are "node" dependent.  These
  2852.      lines will NOT include a full path but will only include file names or
  2853.      directory names.  DO NOT use the '#' in the file name.  This should
  2854.      only be used for "common directory" operation.
  2855.  
  2856.           MAILFILE <filename>
  2857.  
  2858.      Only use a file name.  Don't include a drive or path.  For example:
  2859.  
  2860.           MAILFILE mailfile.txt
  2861.  
  2862.           COMPRESSDIR <directory name>
  2863.  
  2864.      Only use a single name.  Don't include a drive or path.  For example:
  2865.  
  2866.           COMPRESSDIR compress
  2867.  
  2868.           SCANLOGNAME <filename>
  2869.  
  2870.      Only use a file name.  Don't include a drive or path.  For example:
  2871.  
  2872.           SCANLOGNAME scanlog.log
  2873.  
  2874.      Be sure this "default" EchoDor.Ctl file contains ALL the message areas
  2875.      that you intend to carry on your system.  We will use this file during
  2876.      maintenance (EchoUtil /M) to tell EchoUtil where ALL the areas are to
  2877.      be processed.
  2878.  
  2879.      Save the EchoDor.Ctl file.
  2880.  
  2881. 3.   Now we need to edit the DoorDriv.Ctl file.  Make all the changes
  2882.      outlined in the above section.  Then:
  2883.  
  2884.      Remove the BBSPATH line.  It will be necessary to "pick up" the door
  2885.      information file from the default / current directory.
  2886.  
  2887.      We may have to make other changes in the DoorDriv.Ctl file based on
  2888.      the "node" but we'll save that for a little later.  Save the
  2889.      DoorDriv.Ctl file.
  2890.  
  2891. 4.   Create a separate subdirectory for each node that you intend to run.
  2892.  
  2893. 5.   Switch to the subdirectory that you created for one of the nodes.
  2894.      Remember which node this directory is going to be used for.  Then do
  2895.      the following:
  2896.  
  2897.      Copy the EchoDor.Ctl file in the "common" directory to this directory.
  2898.      Do not rename the file.  It should still be EchoDor.Ctl.
  2899.  
  2900.      Copy the DoorDriv.Ctl file in the "common" directory to this
  2901.      directory.  Do not rename the file.  It should still be EchoDor.Ctl.
  2902.  
  2903.  
  2904.                                   Page 43
  2905.  
  2906.  
  2907. EchoDor Version 3.11
  2908. 3/16/92
  2909.  
  2910.      Copy the EchoDor.BAT file into the current directory.
  2911.  
  2912.      If you are using the COMPRESSDIR command in your EchoDor.Ctl file,
  2913.      create a directory with the name you specified in the COMPRESSDIR
  2914.      command.  The COMPRESSDIR command in your EchoDor.Ctl file should only
  2915.      contain the name of the directory.  It should not include any drive or
  2916.      path specifications.
  2917.  
  2918. 6.   Depending on your BBS and system requirements, you may have to edit
  2919.      the DoorDriv.Ctl file.  Based on the node you may have to change:
  2920.  
  2921.      The BAUD line.  If this node runs a locked baud be sure to include a
  2922.      BAUD line.
  2923.  
  2924.      The COMPORT line.  If your BBS does not provide the com port in the
  2925.      door information file, edit this line to tell EchoDor which port to
  2926.      use for this node.
  2927.  
  2928.      Make any other changes that are needed for this specific node. Then
  2929.      save the DoorDriv.Ctl file.
  2930.  
  2931. 7.   Edit the EchoDor.BAT file:
  2932.  
  2933.      Include a line to copy the door information file from THIS NODE's BBS
  2934.      directory to the current directory.
  2935.  
  2936.      Perform the needed operations to get the SCANLOGFILE into where ever
  2937.      it needs to go.  This will depend a great deal on how you process the
  2938.      newly entered messages.
  2939.  
  2940.      Do what ever is needed to get you back to your bbs directory to
  2941.      restart / reload your BBS program.
  2942.  
  2943. 8.   If you use COMPRESS and/or DOWNLOAD, be sure the ECHOCMPS and the
  2944.      ECHODNLD batch files are placed somewhere on your PATH.  This is so
  2945.      the main EchoDor.BAT file can find them.  If you don't want to place
  2946.      these batch files in your path, place a copy of them in each node's
  2947.      subdirectory.
  2948.  
  2949. The following special considerations must be made when performing the mail
  2950. compress and renumber.
  2951.  
  2952. 1.   Be sure that the EchoDor.Ctl file contained in the "common" directory
  2953.      contains EVERY message area that you are carrying on line.
  2954.  
  2955. 2.   When performing purge and renumber, be sure to switch to this
  2956.      directory before you run EchoUtil /M.
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.                                   Page 44
  2967.  
  2968.  
  2969. EchoDor Version 3.11
  2970. 3/16/92
  2971.  
  2972.  
  2973. Multiple Net Setup
  2974.  
  2975. Starting with version 3.03 of EchoDor, multiple net/node numbers may be
  2976. used.  The system will only allow one net/node number per echo area;
  2977. however, your echo areas may be split up into groups with a different
  2978. net/node number for each group.
  2979.  
  2980. When an echo message in entered, the specified net/node number which
  2981. applies to that area is appended to the origin line and placed in the
  2982. origin fields in the message. Normally only one net/node number is
  2983. specified in the EchoDor.Ctl file; however, if you follow the structure of
  2984. the example below you can have EchoDor place the correct net/node number,
  2985. in a multi-net setup, in the origin line and message depending on the echo
  2986. area where the message was entered.
  2987.  
  2988. To use multiple net/node numbers you must group your echo areas together
  2989. using AREATABLE / ENDAREATABLE specifications and multiple ZONE, NET, NODE,
  2990. and POINT commands.  Using the following as an example of what might be in
  2991. a EchoDor.Ctl file:
  2992.  
  2993. Specify your default ADDRESS 1:116/1000.0
  2994.  
  2995. Now specify the areas which should use 1:116/1000.0 in  their origin line.
  2996. The AREATABLE / ENDAREATABLE should be exactly like what would be used for
  2997. a single net.  Notice that the AREATABLE line does not have an address
  2998. specified.  This will cause the AREATABLE to use the  address specified on
  2999. the ADDRESS line above.  You could also specify 1:116/1000.0 on the
  3000. AREATABLE line but it will produce the exact same effect.  See the above
  3001. description for how to specify an AREATABLE.
  3002.  
  3003. AREATABLE
  3004. 1 echoone echotag path ...........etc.
  3005. 2 echotwo echotag path ...........etc.
  3006. ENDAREATABLE
  3007.  
  3008. Now come the areas which should use 8:255/120.0 in their  origin line.
  3009. Notice that an address is specified on  the AREATABLE line.  This will
  3010. override the default  address specified on the ADDRESS line.
  3011.  
  3012. AREATABLE 8:255/120.0
  3013. 3 echothree echotag .......
  3014. 4 echofour  echotag .......
  3015. ENDAREATABLE
  3016.  
  3017. Notice that the AREA NUMBERS in the first AREATABLE and the second
  3018. AREATABLE were NOT duplicated.  An area number may only appear once even
  3019. when you use multiple AREATABLEs.
  3020.  
  3021. Also, if you use the AREADESC to specify the descriptions for your areas,
  3022. all the areas in both nets may be specified in a single AREADESC /
  3023. ENDAREADESC.
  3024.  
  3025. EchoDor is not limited to only two nets.  You may specify as many
  3026. zone:net/node groups as you require for your setup.  The total number of
  3027.  
  3028.                                   Page 45
  3029.  
  3030.  
  3031. EchoDor Version 3.11
  3032. 3/16/92
  3033.  
  3034. areas (echo, local, and net mail) for all areas added together may not
  3035. exceed 255.
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.                                   Page 46
  3091.  
  3092.  
  3093. EchoDor Version 3.11
  3094. 3/16/92
  3095.  
  3096.  
  3097. Purging & Renumbering Areas
  3098.  
  3099. There are now two different methods of purging and renumbering your message
  3100. areas.  One was is to use the three step process of purge, EchoUtil /m,
  3101. renumber.  This method offers some advantages of allowing you to use any
  3102. purge/renumber program you want.  The disadvantage of this method is the
  3103. time involved.  The second way to purge and renumber areas is to use
  3104. EDorPurg.  This program can purge, renumber, and update the user file in a
  3105. single operation.  Both methods are described here.
  3106.  
  3107.  
  3108. The Three Step Method
  3109.  
  3110.      Purging and renumbering your message areas is a three step process.
  3111.      You must not omit any of these steps otherwise the last read pointers
  3112.      will not be correctly set.  These steps include:
  3113.  
  3114.      Old messages are deleted.  At this time the messages should NOT be
  3115.      renumbered.  This is purging.
  3116.  
  3117.      Second, EchoUtil must be run in maintenance mode (EchoUtil /M) to
  3118.      figure out what each users last read pointer should be after the
  3119.      message bases are renumbered (next step).  Note:  This step must be
  3120.      performed BEFORE the actual renumbering the message areas.
  3121.  
  3122.      Third, the message areas are renumbered.
  3123.  
  3124.      There are a number of utilities which can perform the first (purge)
  3125.      and third (renumber) steps.  Starting with EchoDor 3.05, I am
  3126.      providing automated assistance in generating the required files to
  3127.      perform these operations using RASMSM v2.00 or later.
  3128.  
  3129.      RASMAM is a program written by Roger Smith, Jr of 1:366/14.  The
  3130.      program is geared for Opus but works great for any other system which
  3131.      uses the #.msg format for messages.  Please remember that this program
  3132.      is also a shareware program.  Registration of EchoDor does not entitle
  3133.      you to use RASMAM without registration.
  3134.  
  3135.      I currently have a copy of RASMAM available on the WorkBench BBS which
  3136.      can be downloaded using the name OMAM_200.ZIP.
  3137.  
  3138.      RASMAM uses script files to direct it's actions.  To use RASMAM for
  3139.      maintenance, the following batch file could be used:
  3140.  
  3141.      REM - first purge the message areas
  3142.      REM -   "purge.mam" is the file that controls the purging
  3143.      REM
  3144.      RASMAM purge.mam
  3145.      REM
  3146.      REM - then run EchoDor maintenance
  3147.      REM - both EchoDor /M & EchoUtil /M will do it
  3148.      REM
  3149.      EchoUtil /M
  3150.      REM
  3151.  
  3152.                                   Page 47
  3153.  
  3154.  
  3155. EchoDor Version 3.11
  3156. 3/16/92
  3157.  
  3158.      REM - then renumber the message areas
  3159.      REM     "renum.mam" is the file that controls renumbering
  3160.      REM
  3161.      RASMAM renum.mam
  3162.  
  3163.      In the above sample, two files are required for RASMAM.  This is
  3164.      PURGE.MAM which contains information on purging the areas and
  3165.      RENUM.MAM which contains information on renumbering the areas.
  3166.      EchoUtil will assist you in generating these files.  Use one of the
  3167.      following commands:
  3168.  
  3169.           EchoUtil /RASMAM
  3170.  
  3171.           EchoUtil /RASMAM nnn
  3172.  
  3173.           EchoUtil /RASMAM ?
  3174.  
  3175.      If you use the first command, EchoUtil will generate a PURGE.MAM file
  3176.      and a RENUM.MAM file (both in the current directory).  All message
  3177.      areas will be purged to contain 100 messages.
  3178.  
  3179.      If you use the second command, EchoUtil will generate the PURGE.MAM
  3180.      and RENUM.MAM files which will maintain all message areas with "nnn"
  3181.      number of messages.  The "nnn" value may be from 1 to 255.  Any number
  3182.      outside this range will cause EchoUtil to use 100.
  3183.  
  3184.      If you use the third command, EchoUtil will generate the PURGE.MAM and
  3185.      RENUM.MAM files for all message areas.  It will ask for the number of
  3186.      messages to keep in each area as the files are generated.  Any number
  3187.      may be used.
  3188.  
  3189.      These files may be edited after they are created to include any
  3190.      special processing which can be provided by RASMAM.
  3191.  
  3192.      Note:
  3193.           EchoUtil will not check to see if you already have either of
  3194.           these two files in the current directory.  It will just overwrite
  3195.           them if they are out there.  Also, be sure that the TAG in the
  3196.           AREATABLE is unique for each area.  This "TAG" is used when
  3197.           generating the PURGE.MAM and RENUM.MAM files for naming the
  3198.           areas.
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.                                   Page 48
  3215.  
  3216.  
  3217. EchoDor Version 3.11
  3218. 3/16/92
  3219.  
  3220.  
  3221. EDorPurg
  3222.  
  3223. The EDorPurg program can perform the message purge, renumber, relink, and
  3224. user file updates in a single operation.  EDorPurg also compresses your
  3225. message directories and puts all the messages in numerical order within the
  3226. directory.  Performing this operation has the advantage of keeping EchoDor
  3227. running fast.
  3228.  
  3229. Setup
  3230.  
  3231. If your using EDorPurg with EchoDor you should setup an EDorPurg.Cfg file.
  3232. This file contains a list of all the areas and what action should be
  3233. performed on that area.  This parameter file is not required; however,
  3234. after it is set up, you only need to enter EDorPurg with no parameters and
  3235. your system will be purged.
  3236.  
  3237. The EDorPurg.Cfg file is a plain ASCII text file.  Each area occupies one
  3238. line.  Parameters are space delimited (one or more spaces between each
  3239. parameter).
  3240.  
  3241. The first parameter on the line must be the "TAG" name of the area.  This
  3242. "TAG" name must match the "Area Tag Name" in the EchoDor.Ctl file.
  3243. Optionally the "TAG" name can match the area name that is listed in your
  3244. AREAS.BBS file.
  3245.  
  3246. The next parameter tells EDorPurg the type of area.  The valid values are:
  3247.  
  3248.      LOCAL
  3249.      NETMAIL
  3250.      ECHO
  3251.  
  3252. EDorPurg checks to make sure that the type specified matches the type in
  3253. the EchoDor.Ctl file.  If the don't match, a warning is issued and EDorPurg
  3254. will use the type specified in the EchoDor.Ctl file.
  3255.  
  3256. All other parameters can be in any order.  There should be only one
  3257. occurrence of each parameter per line.  The following are valid parameters:
  3258.  
  3259.      KEEP nnn
  3260.  
  3261. This indicates the number of messages to keep in the area.  This parameter
  3262. will always take priority over all other parameters.  For example, if you
  3263. specify KEEP 50 and KILLRECEIVED, after processing there will be only 50
  3264. messages in the area.  EDorPurg will first kill received messages, then it
  3265. will trim the area to 50 messages.
  3266.  
  3267.      FDAYS nnn
  3268.  
  3269. This indicates that files that are older than 'nnn' days old should be
  3270. purged.  This parameter is based on the date of the *.msg file.
  3271.  
  3272.      MDAYS nnn
  3273.  
  3274.  
  3275.  
  3276.                                   Page 49
  3277.  
  3278.  
  3279. EchoDor Version 3.11
  3280. 3/16/92
  3281.  
  3282. This indicates that messages that are older than 'nnn' days old should be
  3283. purged.  This parameter is based on the date of the message.
  3284.  
  3285.      KILLRECEIVED
  3286.  
  3287. This indicates that messages that have been "received" should be deleted.
  3288.  
  3289. An example of a purge line might be:
  3290.  
  3291.           NetArea NETMAIL KEEP 75 KILLRECEIVED
  3292.  
  3293.           or
  3294.  
  3295.           EchoArea ECHO KEEP 150 MDAYS 30
  3296.  
  3297. After you have set up your EchoDor.Ctl file, you can have EchoUtil build
  3298. you an initial EDorPurg.Ctl file.  To build this file enter:
  3299.  
  3300.           EchoUtil /EDorPurg
  3301.  
  3302.           EchoUtil /EDorPurg 150
  3303.  
  3304.           EchoUtil /EDorPurg ?
  3305.  
  3306. The first example will generate an EDorPurg.Ctl file for every area with a
  3307. KEEP 100 value.
  3308.  
  3309. The second example will generate an EDorPurg.Ctl file for every area with a
  3310. KEEP 150 value.
  3311.  
  3312. The last example will generate an EDorPurg.Ctl file for every area and will
  3313. ask for the KEEP value.
  3314.  
  3315. After you generate the EDorPurg.Ctl file you can use an editor to make
  3316. additional changes.
  3317.  
  3318. Be sure you have a blank line after the last entry in the EDorPurg.Ctl
  3319. file; otherwise, you'll get strange messages about the last area.
  3320.  
  3321. Note:
  3322. EchoUtil will not check to see if you already have an EDorPurg.Ctl file in
  3323. the current directory.  It will just overwrite it if is out there.  Also,
  3324. be sure that the TAG in the AREATABLE is unique for each area.  This "TAG"
  3325. is used when generating the control file for naming the areas.
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.                                   Page 50
  3339.  
  3340.  
  3341. EchoDor Version 3.11
  3342. 3/16/92
  3343.  
  3344. EDorPurg Parameters
  3345.  
  3346. EDorPurg has a number of command line parameters to help tailor its
  3347. operation to your needs.
  3348.  
  3349. Note:
  3350.      Some of the parameters use the same letter to mean different things.
  3351.      If the letter is followed by a parameter then it means one thing, if
  3352.      the letter is used without any parameter it means something else.
  3353.  
  3354. For example:
  3355.  
  3356.      -e<file>  specifies the path and file name of the EchoDor.Ctl file.
  3357.      -e        (without the file name) specifies to process only echo
  3358.                areas.
  3359.  
  3360. The following command line parameters are available:
  3361.  
  3362.      -a        specifies that EDorPurg should process all areas except
  3363.                passthru areas.  This parameter is most useful when using
  3364.                EDorPurg with an Areas.BBS file.
  3365.  
  3366.      -a<file>  specifies that EDorPurg should use an AREAS.BBS file in
  3367.                place of an EchoDor.Ctl file.  The <file> parameter
  3368.                specifies a full path and file name of the AREAS.BBS file to
  3369.                be used.
  3370.  
  3371.                To specify a local only area using an AREAS.BBS, specify the
  3372.                area tag and path only.  Do not specify any nodes.
  3373.  
  3374.                To specify a net mail area, use the tag name NETMAIL.
  3375.  
  3376.      -d<dir>   This tells EDorPurg to purge messages in the specified
  3377.                directory.  Do not put <> around the directory name.  When
  3378.                using the -d<dir> command line parameter, you must also use
  3379.                -e, -n, or -l command to indicate the area being echo, net
  3380.                mail, or local.
  3381.  
  3382.      -e        This parameter tells EdorPurg to process only echo areas.
  3383.                Net Mail and Local areas will not be purged.  When used with
  3384.                the -d<dir> command, this parameter tells EDorPurg that the
  3385.                area being processed is an Echo area.
  3386.  
  3387.      -e<file>  This parameter tells EDorPurg the path and name of the
  3388.                EchoDor.Ctl file to be used.  If the -e<file> parameter is
  3389.                not specified, EDorPurg will look for a control file named
  3390.                EchoDor.Ctl file in the current directory.  Do not put <>
  3391.                around the file name.
  3392.  
  3393.      -K<nnn>   This parameter tells EDorPurg the number of messages to
  3394.                keep.  The 'nnn' should be replaced with a number.  Do not
  3395.                put <> around the number.  For example:
  3396.  
  3397.                     -K150
  3398.  
  3399.  
  3400.                                   Page 51
  3401.  
  3402.  
  3403. EchoDor Version 3.11
  3404. 3/16/92
  3405.  
  3406.                would tell EDorPurg to keep 150 messages in the area.
  3407.  
  3408.      -KRECV    This parameter tells EDorPurg to kill received messages.
  3409.  
  3410.      -l        This parameter tells EDorPurg to process only local areas.
  3411.                Net Mail and Echo areas will not be purged.  When used with
  3412.                the -d<dir> command, this parameter tells EDorPurg that the
  3413.                area being processed is a local area.
  3414.  
  3415.      -l<file>  This parameter tells EDorPurg the name of the log file where
  3416.                purging information should be placed.  Do not put <> around
  3417.                the file name.  If this parameter is omitted and a LOG
  3418.                filename parameter is in the EchoDor.Ctl file, that log file
  3419.                will be used.
  3420.  
  3421.      -n        This parameter tells EDorPurg to process only net mail
  3422.                areas.  Local and Echo areas will not be processed.  When
  3423.                used with the -d<dir> command, this parameter tells EDorPurg
  3424.                that the area being processed is a net mail area.
  3425.  
  3426.      -p        This parameter tells EDorPurg to only purge the areas.  No
  3427.                renumbering should be done.
  3428.  
  3429.      -q        This enables "QUIET" mode.  Very little output will be
  3430.                displayed to the screen.  This does not effect output to the
  3431.                log file.
  3432.  
  3433.      -r        This parameter tells EDorPurg to renumber only.  No purge of
  3434.                the area will be done.
  3435.  
  3436.      -REC      Force recovery of areas.  If this parameter is specified,
  3437.                EDorPurg will only operate on errors that need to be
  3438.                recovered.  No other operation will be performed.  This
  3439.                parameter is usually not required as EDorPurg can figure out
  3440.                for itself that it should recover.
  3441.  
  3442.      -s<file>  This parameter specifies a file that contains tag names of
  3443.                the areas that should be purged.  Do not put <> around the
  3444.                file name.
  3445.  
  3446.      -t<tag>   This parameter specifies a single area by tag name.  Do not
  3447.                put <> around the tag name.
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.                                   Page 52
  3463.  
  3464.  
  3465. EchoDor Version 3.11
  3466. 3/16/92
  3467.  
  3468. Operation
  3469.  
  3470. EDorPurg does not operate as most message renumbering / purging utilities
  3471. run.  The following is a summary of the way EDorPurg performs its
  3472. operation.  This information is provided for the curious.
  3473.  
  3474. EDorPurg first counts the messages in the directory to be purged.  It also
  3475. checks to see if any other indicators (such FDAYS) has been specified and
  3476. checks all messages to see if it should be kept.
  3477.  
  3478. If messages are to be purged, a new directory is created.  This directory
  3479. is named the same as the original directory with the exception of an
  3480. extension of @@@.
  3481.  
  3482. EDorPurg writes a recovery file to the new directory.  This recovery file
  3483. contains a list of the old message numbers, what the new message numbers
  3484. will be, and relinking information.
  3485.  
  3486. The messages that are to be kept are renamed into the new directory.  This
  3487. renaming moves the message from one directory to another (this is not a
  3488. copy but a move) and sets the name of the message to its new number.
  3489.  
  3490. All old messages remaining in the original directory are erased.
  3491.  
  3492. Any file that remains in the old directory (such as ORIGIN or LASTREAD) is
  3493. moved to the new directory.
  3494.  
  3495. The old directory is removed.
  3496.  
  3497. The new directory is renamed so it's name will be the same as the old
  3498. directory.
  3499.  
  3500. The next/prior message numbers are then relinked.
  3501.  
  3502. The EchoDor user file last read pointers are updated.
  3503.  
  3504. Any 'LASTREA?' files are updated.
  3505.  
  3506. The recovery file is erased.
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.                                   Page 53
  3525.  
  3526.  
  3527. EchoDor Version 3.11
  3528. 3/16/92
  3529.  
  3530. Recovery Method
  3531.  
  3532. EDorPurg contains complete recovery should some problem prevent it from
  3533. completing its purge / renumber operation.  With most purging / renumbering
  3534. utilities, should some problem strike during the purge/renumber operation,
  3535. your left with a mess in the directory and users last read pointers are
  3536. left pointing into who knows where.
  3537.  
  3538. To combat this problem, EDorPurg writes recovery information to a file
  3539. called EDorPurg.REC.  This file contains complete information about the
  3540. state of the message area before the purge and how the renumbering will
  3541. effect user last read pointers.
  3542.  
  3543. Should a problem occur where EDorPurg is not able to complete its
  3544. operation, just restart EDorPurg.  It will automatically recover the area
  3545. that it was unable to complete.  If you only want EDorPurg to recover and
  3546. not to purge other areas, start EDorPurg with the -REC parameter.
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.                                   Page 54
  3587.  
  3588.  
  3589. EchoDor Version 3.11
  3590. 3/16/92
  3591.  
  3592.  
  3593. FastLink
  3594.  
  3595. FastLink is a program which relinks the prior message / next message
  3596. pointers by subject.  This allows the reader to use the +, -, and * options
  3597. on the read command.
  3598.  
  3599. Parameters
  3600.  
  3601. FastLink has a number of command line parameters to help tailor the
  3602. operation to your needs.
  3603.  
  3604. Note:
  3605.      Some of the parameters use the same letter to mean multiple things.
  3606.      If the letter is followed by a parameter then it means one thing, if
  3607.      the letter is used without any parameter it means something else.  For
  3608.      example:
  3609.  
  3610.      -e<file>  specifies the path and file name of the EchoDor.Ctl file.
  3611.  
  3612.      -e        (without the file name) specifies to process only echo
  3613.                areas.
  3614.  
  3615. The following command line parameters are available:
  3616.  
  3617.      -a        specifies that FastLink should process all areas except
  3618.                passthru areas.  This parameter is most useful when using
  3619.                FastLink with an Areas.BBS file.
  3620.  
  3621.      -a<file>  specifies that FastLink should use an AREAS.BBS file in
  3622.                place of an EchoDor.Ctl file.  The <file> parameter
  3623.                specifies a full path and file name of the AREAS.BBS file to
  3624.                be used.
  3625.  
  3626.                To specify a local only area using an AREAS.BBS, specify the
  3627.                area tag and path only.  Do not specify any nodes.
  3628.  
  3629.                To specify a net mail area, use the tag name NETMAIL.
  3630.  
  3631.      -d<dir>   This tells FastLink to relink messages in the specified
  3632.                directory.  Do not put <> around the directory name.
  3633.  
  3634.      -e        This parameter tells FastLink to process only echo areas.
  3635.                Net mail and Local areas will not be purged.
  3636.  
  3637.      -e<file>  This parameter tells EDorPurg the path and name of the
  3638.                EchoDor.Ctl file to be used.  If the -e<file> parameter is
  3639.                not specified, EDorPurg will look for a control file named
  3640.                EchoDor.Ctl file in the current directory.  Do not put <>
  3641.                around the file name.
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.                                   Page 55
  3649.  
  3650.  
  3651. EchoDor Version 3.11
  3652. 3/16/92
  3653.  
  3654.      -l        This parameter tells FastLink to process only local areas.
  3655.                Net mail and Echo areas will not be purged.  Normally this
  3656.                parameter will not be used.  EchoDor keeps messages in local
  3657.                areas properly linked regardless of the subject.  Use this
  3658.                parameter with care.
  3659.  
  3660.      -l<file>  This parameter tells FastLink the name of the log file where
  3661.                purging information should be placed.  Do not put <> around
  3662.                the file name.  If this parameter is omitted and a LOG
  3663.                filename parameter is in the EchoDor.Ctl file, that log file
  3664.                will be used.
  3665.  
  3666.      -n        This parameter tells EDorPurg to process only net mail
  3667.                areas.
  3668.  
  3669.      -q        This enables "QUIET" mode.  Very little output will be
  3670.                displayed to the screen.  This does not effect output to the
  3671.                log file.
  3672.  
  3673.      -s<file>  This parameter specifies a file that contains tag names of
  3674.                the areas that should be purged.  Do not put <> around the
  3675.                file name.  When using FastLink after mail is tossed, this
  3676.                parameter will tell FastLink exactly which mail areas need
  3677.                to be processed.
  3678.  
  3679.      -t<tag>   This parameter specifies a single area by tag name.  Do not
  3680.                put <> around the tag name.
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.                                   Page 56
  3711.  
  3712.  
  3713. EchoDor Version 3.11
  3714. 3/16/92
  3715.  
  3716. Operation
  3717.  
  3718. Normally FastLink is used only on Echo areas.  Net mail is usually a number
  3719. of disjointed messages.  Local message bases keep by EchoDor will always be
  3720. properly linked.
  3721.  
  3722. After Tossing Mail
  3723.  
  3724.      The best time to run FastLink is immediately after you have completed
  3725.      tossing in coming mail.  Most mail tossers will write a file
  3726.      containing the names of the Echos that have been tossed.  Use this
  3727.      file with the -s<file> parameter to have FastLink relink only the
  3728.      message bases that have received messages.
  3729.  
  3730.      If your tosser cannot write a scan file, just run FastLink with the -e
  3731.      parameter after receiving mail.  FastLink will scan each area and
  3732.      relink only areas that have not been processed.  Although this
  3733.      operation is not as fast as using the -s<file> parameter, it's still
  3734.      pretty quick.
  3735.  
  3736.      If you run FastLink from a directory other than the EchoDor directory,
  3737.      you will need to specify the location of the EchoDor.Ctl file.  Use
  3738.      the -e<file> parameter.  When running FastLink without a scan file (as
  3739.      described above) the command line parameter will be:
  3740.  
  3741.           FastLink -eC:\Path\EchoDor.Ctl -e
  3742.  
  3743.      There are two -e parameters, one with a file name (indicating the
  3744.      location of EchoDor.Ctl) and another indicating process only echo
  3745.      areas.
  3746.  
  3747.  
  3748. After EDorPurg
  3749.  
  3750.      If you do not want to run FastLink after receiving mail, the next best
  3751.      place to run is immediately after purging / renumbering with EDorPurg.
  3752.      Do not confuse the "relinking" phase of EDorPurg with the operation
  3753.      performed by FastLink.  EDorPurg updates the prior / next message
  3754.      pointers with the new message numbers (after renumbering).  FastLink
  3755.      relinks messages based on subject.
  3756.  
  3757.      It is faster to run FastLink after running EDorPurg than before.  This
  3758.      is because:
  3759.  
  3760.           1.   There are less messages that have to be checked.
  3761.  
  3762.           2.   EDorPurg has updated already linked messages so FastLink
  3763.                won't have to rewrite these messages.
  3764.  
  3765.           3.   EDorPurg will have less messages to link because messages
  3766.                not yet linked will not require updating.
  3767.  
  3768.      It is again suggested that only Echo areas be processed by FastLink.
  3769.      The command line to do this is:
  3770.  
  3771.  
  3772.                                   Page 57
  3773.  
  3774.  
  3775. EchoDor Version 3.11
  3776. 3/16/92
  3777.  
  3778.           FastLink -e
  3779.  
  3780.      or if you need to specify the location of the EchoDor.Ctl file:
  3781.  
  3782.           FastLink -eC:\path\EchoDor.Ctl -e
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.                                   Page 58
  3835.  
  3836.  
  3837. EchoDor Version 3.11
  3838. 3/16/92
  3839.  
  3840.  
  3841. EchoDor Operation
  3842.  
  3843. EchoDor operation is simple.  It has been designed to look like part of
  3844. your BBS.  The menu files can be changed to look like the rest of your
  3845. system as well.  The command letters may NOT be changed.
  3846.  
  3847.  
  3848. Menu Commands
  3849.  
  3850. The valid commands from the main menu are as follows:
  3851.  
  3852.  
  3853. J - Join Conference
  3854. A - Area Change
  3855.  
  3856.      When this function is selected, the user is presented with a prompt
  3857.      asking for the echo mail area number, or the name, or 'L' to list the
  3858.      areas.  If you have defined a description table in your EchoDor.Ctl
  3859.      file, the description table will be listed. If you are using the
  3860.      USERAREAFILE and the SYSOPAREAFILE parameters, the corresponding file
  3861.      will be displayed. If graphic versions of the file exist, they will be
  3862.      displayed if the user supports ANSI or ASCII graphics.
  3863.  
  3864.      If your BBS system uses the term area instead of conference, modify
  3865.      the menu to say [A]rea Change.  EchoDor will except either J or A to
  3866.      change conferences.
  3867.  
  3868. C - Check Personal Mail
  3869.  
  3870.      When this function is selected, the user is presented with a prompt
  3871.      that asks him/her to verify that mail is to be checked.  During the
  3872.      check, only conferences that have been selected in the IGNORE EDITOR
  3873.      will be checked.  The user can abort the scan at any time by pressing
  3874.      'S'.  When a message is found, the header information will be
  3875.      displayed.
  3876.  
  3877. F - Toggle Full Screen Editor
  3878.  
  3879.      This function allows the user to turn the full screen editor on or off
  3880.      regardless of his/her graphics setting.  See the FULL SCREEN EDITOR
  3881.      reference section for instructions for its use.
  3882.  
  3883. H - Invoke the Help System.
  3884.  
  3885.      This displays the help menu to the user.  See the HELP SYSTEM
  3886.      reference section for information of the help system.
  3887.  
  3888. I - Ignore Editor.
  3889.  
  3890.      This editor allows the  user to include or exclude any conference from
  3891.      the 'check personal mail', 'check new messages', or 'Pack mail'
  3892.      functions.
  3893.  
  3894. L - Leave Sysop a Comment.
  3895.  
  3896.                                   Page 59
  3897.  
  3898.  
  3899. EchoDor Version 3.11
  3900. 3/16/92
  3901.  
  3902.  
  3903.      This option lets the user enter a message into the comment area.  This
  3904.      option is not valid if the NOCOMMENT parameter is specified.  If you
  3905.      decide to disable comments, you should edit the echo menus to remove
  3906.      the option.
  3907.  
  3908. P - Pack Mail section.
  3909.  
  3910.      This function allows the user to enter the Pack Mail section.  Within
  3911.      this section the user can pack mail for download.
  3912.  
  3913. R - Read Messages.
  3914.  
  3915.      This function allows the user to read & reply to the messages in the
  3916.      current echo mail area.  The user is presented with a sub-menu of
  3917.      options after each message is displayed.
  3918.  
  3919. S - Scan Messages.
  3920.  
  3921.      This function allows the user to display a list of message headers.
  3922.      (IE:  To....From....Sbj) Etc.
  3923.  
  3924. E - Enter a Message.
  3925.  
  3926.      EchoDor users may select a line editor much like most BBS's, or a full
  3927.      screen editor.  This full screen editor is the same editor found in
  3928.      PRODOOR. (The PCBOARD Door).  See the full screen editor section for
  3929.      more information.
  3930.  
  3931. X - Expert Toggle.
  3932.  
  3933.      This turns on and off the main menu display. Just like most BBS's.
  3934.  
  3935. Q - Quit EchoDor.
  3936.  
  3937.      In local mode this function will return you to the DOS prompt.  In
  3938.      On-line mode, this function will return the caller to the BBS.
  3939.  
  3940. Z - Sysop commands.
  3941.  
  3942.      This function enters the SYSOP menu.  From the SYSOP menu you may Copy
  3943.      or Doctor messages, read the nodelist or check EchoDor users.
  3944.  
  3945.      If you can't get to the sysop menu and you are a sysop, use EchoUser
  3946.      /S and set your SYSOP flag in your user record.  Read the section on
  3947.      EchoUser.
  3948.  
  3949. Reading messages
  3950.  
  3951. After activating the read message command (R), you will then be shown the
  3952. message in the area where your last read pointer is set.  At the bottom of
  3953. the screen, a prompt line will be shown which will give you a set of
  3954. options.  Each option is selected by typing the first letter of that
  3955. option.  You may also select a specific message to be displayed by entering
  3956.  
  3957.  
  3958.                                   Page 60
  3959.  
  3960.  
  3961. EchoDor Version 3.11
  3962. 3/16/92
  3963.  
  3964. the message number of the desired message in place of an option letter.  If
  3965. the message is public or address to you or from you, it will be displayed.
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.                                   Page 61
  4021.  
  4022.  
  4023. EchoDor Version 3.11
  4024. 3/16/92
  4025.  
  4026.  
  4027. Entering messages
  4028.  
  4029. There are two ways to enter messages:
  4030.  
  4031. 1) With the full-screen editor.
  4032. 2) With the line editor.
  4033.  
  4034. Each of these methods will be described separately.  If you are using IBM
  4035. ANSI graphics, then the full screen editor will be chosen for you.  If not,
  4036. then the line editor will be chosen.
  4037.  
  4038. Line Editor
  4039.  
  4040. The line editor is the simplest of the two editors.  You are initially
  4041. placed in "entry mode" where you will just have to type your message.  The
  4042. lines will be wrapped automatically for you.  You press enter at the
  4043. beginning of a line to leave "entry mode". After leaving "entry mode", you
  4044. will be presented with a small menu consisting of these options:
  4045.  
  4046. [C]ont
  4047.  
  4048.      Continue the current message. This will simply place you back into the
  4049.      line editor's "entry mode" at the end of the last line you entered.
  4050.  
  4051. [I]nsert
  4052.  
  4053.      This will allow you to insert a line anywhere into the message.  When
  4054.      you select this option the line editor will ask you where you want to
  4055.      insert the line.
  4056.  
  4057. [D]elete
  4058.  
  4059.      This option will let you delete any line in the message.  When you
  4060.      select this option you will be asked the starting and ending line(s)
  4061.      you want to delete.
  4062.  
  4063. [V]isual
  4064.  
  4065.      If you are using ANSI graphics, this will let you re-enter the full
  4066.      screen editor.
  4067.  
  4068. [Q]uote
  4069.  
  4070.      If you are entering a reply, you may quote lines directly from the
  4071.      original message. When you select this option you will be given
  4072.      another small menu which will allow you to:
  4073.  
  4074.           List the original message.
  4075.  
  4076.           Specify the starting line number to quote.
  4077.  
  4078.           Specify the ending line number to quote.
  4079.  
  4080.           Display the message your current writing.
  4081.  
  4082.                                   Page 62
  4083.  
  4084.  
  4085. EchoDor Version 3.11
  4086. 3/16/92
  4087.  
  4088.  
  4089.           Specify the line where the quoted lines are to be inserted.
  4090.  
  4091. [A]bort
  4092.  
  4093.      This will throw the message that your are currently entering away and
  4094.      exit the line editor.
  4095.  
  4096. [S]ave
  4097.  
  4098.      This will save the message you are entering and will exit the line
  4099.      editor.
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.                                   Page 63
  4145.  
  4146.  
  4147. EchoDor Version 3.11
  4148. 3/16/92
  4149.  
  4150. Full Screen Editor
  4151.  
  4152. The EchoDor full screen editor is the same editor that appears in PRODOOR
  4153. (Thanks  Sam!).  It provides full-screen editing for on line message entry.
  4154. Full screen editing requires ANSI terminal emulation.  The full screen
  4155. editing commands are WordStar-Like control characters.  If your terminal
  4156. program provides ANSI keyboard emulation, you will also be able to use the
  4157. indicated function keys.  Here is a summary of the editor commands:
  4158.  
  4159.  
  4160. << Cursor Motion >>
  4161.  
  4162.      Ctrl-S  Move left 1 character           (Left arrow key)
  4163.      Ctrl-D  Move right 1 character          (Right arrow key)
  4164.      Ctrl-E  Move up 1 line                  (Up arrow key)
  4165.      Ctrl-X  Move down 1 line                (Down arrow key)
  4166.      Ctrl-A  Move left 1 word
  4167.      Ctrl-F  Move right 1 word
  4168.      Ctrl-I  Tab cursor to next tab stop      (Tab key)
  4169.      Ctrl-P  Move cursor to line end         (End key)
  4170.  
  4171.  
  4172. << Scrolling >>
  4173.  
  4174.      Ctrl-R  Move up a page                  (PgUp key)
  4175.      Ctrl-C  Move down a page                (PgDn key)
  4176.  
  4177. << Delete >>
  4178.  
  4179.      Ctrl-G  Delete character under cursor
  4180.      Ctrl-H  Delete character to the left of the cursor
  4181.                                              (Backspace)
  4182.      Ctrl-T  Delete the word following the cursor
  4183.      Ctrl-Y  Delete the current line
  4184.      Ctrl-J  Join current line with next line
  4185.  
  4186. << Miscellaneous commands>>
  4187.  
  4188. Ctrl-B    Reformat paragraph.  A paragraph ends with the first line that is
  4189.           blank or that has leading spaces.
  4190.  
  4191. Ctrl-K    Visual quote mode.  This allows you to display the original
  4192.           message and copy lines from it to the current message.
  4193.  
  4194. Ctrl-L    Clear screen and re display.       (Home key)
  4195.           This also scrolls the screen so the cursor line is in the middle
  4196.           of the display.
  4197.  
  4198. Ctrl-N    Insert a RETURN.  Splits line at the cursor.
  4199.  
  4200. Ctrl-O    Review the text of the Original message you were reading or
  4201.           replying to.  If your not replying to a message this key does
  4202.           nothing.
  4203.  
  4204.  
  4205.  
  4206.                                   Page 64
  4207.  
  4208.  
  4209. EchoDor Version 3.11
  4210. 3/16/92
  4211.  
  4212. Ctrl-Q    Visual quote mode.  This allows you to display the original
  4213.           message and copy lines from it to the current message.
  4214.  
  4215. Ctrl-V    Toggle insert/over type mode.      (Ins key)
  4216.  
  4217. ESC       Exit visual mode and return to the Message Entry Command prompt.
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.  
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.                                   Page 65
  4269.  
  4270.  
  4271. EchoDor Version 3.11
  4272. 3/16/92
  4273.  
  4274.  
  4275. Insert Mode versus Over type Mode
  4276.  
  4277. In insert mode, all characters typed are INSERTED before the cursor. The
  4278. ENTER key splits the line and BACKSPACE can re-join lines.
  4279.  
  4280. In over type mode, characters "type over" what was on the screen before.
  4281. Over type mode also disables the automatic line SPLIT / JOIN available in
  4282. insert mode.  Use ^N(split) and ^J(join) to manually split and join lines
  4283. while in over type mode.
  4284.  
  4285.  
  4286. Keyboard emulation
  4287.  
  4288. The easiest way to control the cursor in Visual Edit mode is to use your
  4289. cursor keys.  Most popular terminal programs provide some sort of keyboard
  4290. emulation.  Unfortunately, this emulation is either incomplete or requires
  4291. you to go through an involved configuration process.
  4292.  
  4293. The WordStar* command set was chosen as a control-character command set
  4294. because it can function on virtually any keyboard and with any terminal
  4295. emulation mode.  It also has the advantage of letting you keep your fingers
  4296. on the "home" keys while moving the cursor around.
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.                                   Page 66
  4331.  
  4332.  
  4333. EchoDor Version 3.11
  4334. 3/16/92
  4335.  
  4336.  
  4337. Visual Quote
  4338.  
  4339. EchoDor now has Visual Quote.  This allows users of the full screen editor
  4340. to more easily quote from a message.  The use of Visual Quote is intuitive.
  4341.  
  4342. The first time Ctrl-Q or Ctrl-K is pressed the original message is
  4343. displayed to the user.  The user then uses the up and down arrow keys or
  4344. the page up and page down keys to move the cursor to the line to be quoted.
  4345. Then the space bar is pressed.  A tag indicator is placed to the left hand
  4346. side of the line and the cursor is moved to the next line.  The user may
  4347. tag as many lines as desired.  When all the desired lines are tagged press
  4348. Ctrl-Q or ESC to return to the message being written.
  4349.  
  4350. To insert the lines tagged press Ctrl-Q or Ctrl-K again.  A message will
  4351. appear at the bottom of the screen saying:
  4352.  
  4353. [I]nsert quote or [T]ag:
  4354.  
  4355. If "I" is pressed the tagged lines will be inserted into the message above
  4356. the current cursor line.  If "T" is pressed the user is returned to the
  4357. original to allow tagging a new set of lines.
  4358.  
  4359. If you use the NEWQUOTE option in the EchoDor.Ctl file, after the user tags
  4360. the lines to be quoted, EchoDor will insert the lines immediately before
  4361. the cursor.
  4362.  
  4363. EchoDor pays particular attention to the reformatting of inserted lines.
  4364. Each inserted line is preceded by "xx>" with "xx" being the initials of the
  4365. person being quoted.  Every line within a paragraph is adjusted to make it
  4366. correctly fit in the message.  Blank lines and paragraph structure will be
  4367. maintained.
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.                                   Page 67
  4393.  
  4394.  
  4395. EchoDor Version 3.11
  4396. 3/16/92
  4397.  
  4398.  
  4399. Using EchoDor Locally
  4400.  
  4401. EchoDor also works very well as a local message reader.  To use it in this
  4402. manner, start EchoDor with a batch file something like this:
  4403.  
  4404. rem
  4405. rem Set the directory and drive first
  4406. rem
  4407. C:
  4408. cd \EchoDor
  4409. rem
  4410. rem Now start EchoDor as the sysop -- this is much like
  4411. rem local mode but it will log you on with the name you
  4412. rem specified as the sysop.
  4413. rem
  4414. ECHODOR /S
  4415. rem
  4416. rem Check for mail to be sent, the name of the SCANLOG.TXT
  4417. rem file would depend on your configuration.
  4418. rem
  4419. rem
  4420. IF NOT EXIST SCANLOG.TXT GOTO EXIT
  4421. rem
  4422. rem  Now run the mail packer/scanner (could be ConfMail).
  4423. rem
  4424. QM SCAN PACK <what ever commands you need>
  4425. rem
  4426. rem we're all done
  4427. rem
  4428. :EXIT
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.                                   Page 68
  4455.  
  4456.  
  4457. EchoDor Version 3.11
  4458. 3/16/92
  4459.  
  4460.  
  4461. Special local keys
  4462.  
  4463. While the user is on line, EchoDor provides some additional functions to
  4464. the SYSOP.
  4465.  
  4466. ALT-I     System Information
  4467.  
  4468.      This provides the following information:
  4469.  
  4470.           Baud Rate
  4471.           Local flag
  4472.           Graphics Setting
  4473.           Time Left
  4474.           Com Port
  4475.           User Name
  4476.           Access Level
  4477.           Time credit
  4478.           Time left
  4479.           Node Number
  4480.  
  4481. ALT-C    Forced Chat
  4482.  
  4483.      When ALT-C is pressed, the user is placed into CHAT mode.  EchoDor
  4484.      does not provide a split screen chat.
  4485.  
  4486.      To exit chat the SYSOP must press <esc>.
  4487.  
  4488. ALT-D    Drop to DOS
  4489.  
  4490.      This allows the SYSOP to drop to DOS for those Quick checks and fixes.
  4491.  
  4492. Up Arrow
  4493.      This will add 2 minutes to the users time.
  4494.  
  4495. Down Arrow
  4496.      This will subtract 2 minutes from the users time.
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.                                   Page 69
  4517.  
  4518.  
  4519. EchoDor Version 3.11
  4520. 3/16/92
  4521.  
  4522.  
  4523. Message Header Description
  4524.  
  4525. Every message in the system contains control information along with the
  4526. text that is entered by the user.  The sysop using EchoDor can modify the
  4527. information in this header using the Doctor command (Z on the main menu
  4528. then D).  The following fields can be modified:
  4529.  
  4530. A.   From
  4531.      This field contains the name of the person that entered the message.
  4532.  
  4533. B.   To
  4534.      This field contains the name of the person that is to receive the
  4535.      message.
  4536.  
  4537. C.   Subject
  4538.      This field contains the subject of the message.  In the case of a file
  4539.      request or file attach type message (see below) this field contains
  4540.      the file name that is being attached or requested.
  4541.  
  4542. D.   Date/Time
  4543.      This is the date and time when the message was entered.  The format of
  4544.      this field must be:
  4545.  
  4546.           16 Jan 90  13:01:05
  4547.  
  4548. E.   Origin
  4549.      This is the zone:net/node.point number that originated the message.
  4550.      This field is not used with local messages (Type B).
  4551.  
  4552. F.   Destination
  4553.      The is the zone:net/node.point number where the message is going.
  4554.      This field is not relevant in echo message (Type E or I) or in local
  4555.      messages (Type B).
  4556.  
  4557. G.   Cost
  4558.      This is amount of money it costs in cents to send the message.  This
  4559.      information is retrieved from the node list.  This field is not used
  4560.      for echo messages or local messages.
  4561.  
  4562. H.   Reply
  4563.      When a person enters a reply this is the message number to which
  4564.      he/she is replying.  When the message is an initial entry, this field
  4565.      will be zero.
  4566.  
  4567. I.   Next-Reply
  4568.      When a person enters a reply this field is set in the original message
  4569.      to the message number of the reply.  When the message is an initial
  4570.      entry, this field will be zero.
  4571.  
  4572.      This field has a special use for echo mail.  Message number 1 in an
  4573.      echo area is usually used by the mail processor (ConfMail or QM) to
  4574.      point to the highest message that has been scanned.  Message number 1
  4575.      is usually refereed to as the "high water mark".  This field contains
  4576.      the message number of the highest message scanned.
  4577.  
  4578.                                   Page 70
  4579.  
  4580.  
  4581. EchoDor Version 3.11
  4582. 3/16/92
  4583.  
  4584.  
  4585. J.   Private
  4586.      Messages in all areas may be marked private.  If this flag is set to
  4587.      "Yes" then only the sender, the receiver, and the sysop may read the
  4588.      message.  Although not allowed in most echoes, EchoDor does support
  4589.      private echo mail messages if present.
  4590.  
  4591. K.   Crash
  4592.      This flag is used to tell the mail processing program to try to get
  4593.      the message sent as soon as possible.  Some mailers refer to this type
  4594.      of mail as contentious mail.
  4595.  
  4596. L.   Sent
  4597.      This flag is set by the mail processor to indicate that the message
  4598.      has been bundled to be sent.  This flag does not indicate that the
  4599.      message has actually left your system.
  4600.  
  4601. M.   File Attach
  4602.      Some messages are sent with a file.  If this flag is set to "Yes" then
  4603.      the subject field will contain the full path name of the file(s) to be
  4604.      sent with the message.
  4605.  
  4606. N.   Kill-Sent
  4607.      After a message is sent, it is usually left in the area from where it
  4608.      came.  If this flag is set to "Yes" then the message will be delete
  4609.      after it is bundled by the mail packer.
  4610.  
  4611. O.   Local
  4612.      This flag is set to "Yes" if the message was entered on your system.
  4613.      If the message came from some other system this flag will be set to
  4614.      "No".
  4615.  
  4616. P.   F'req
  4617.      This is a file request flag.  If set to "Yes" then the subject line
  4618.      contains the name of a file that you want sent to you from the
  4619.      destination system.  Files listed in this type of message should not
  4620.      contain path names.
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.                                   Page 71
  4641.  
  4642.  
  4643. EchoDor Version 3.11
  4644. 3/16/92
  4645.  
  4646.  
  4647. How do file-requests work?
  4648. When a file request is generated, two files are created and placed in the
  4649. outbound directory. The first file contains the name of the file(s) that
  4650. you are requesting from the remote system. The second file specifies how
  4651. and when the transfer will take place. (i.e. crash-mail, normal, direct,
  4652. etc.). The stem for each of these files is made up of two four-character
  4653. hexadecimal numbers specifying the net and node number that the request
  4654. will be sent to.
  4655.  
  4656. The first file created is the .REQ file. If this file already exists then
  4657. it will be appended to. The name of the file being requested is simply
  4658. placed in the file in plain ASCII.
  4659.  
  4660. The second file created will have the extension of ".FLO", ".CLO", ".DLO",
  4661. or ".HLO". This tells the front-end processor how and when the file will be
  4662. transferred. The various methods are summarized below:
  4663.  
  4664.    Name      Ext  Description
  4665. ----------- ----  -----------------------------------------------
  4666. Normal      FLO   Normal transfer.  It will occur at the time you
  4667.                   specify in your mailer program.  Normal
  4668.                   requests can also be "routed" by your mailer
  4669.                   program.
  4670.  
  4671. Crash-Mail  CLO   The request will be processed at the earliest
  4672.                   possible time.
  4673.  
  4674. Hold        HLO   Hold-for-pickup.  The remote system must poll
  4675.                   (call) your system in order to receive the
  4676.                   request.
  4677.  
  4678. Direct      DLO   This is a direct request.  It will occur at the
  4679.                   time you specify in your mailer program;
  4680.                   however, this request must go directly to the
  4681.                   specified address and cannot be routed.
  4682.  
  4683. EchoUtil generates file-requests with the "/GET" option. On the command
  4684. line, you simply need to specify the filename and the node that you want to
  4685. request from.
  4686.  
  4687. Examples:
  4688.  
  4689. EchoUtil /GET echo308.arc from 300/9
  4690.  
  4691.      This generates a file request to a system for the file "ECHO308.ARC".
  4692.      It will send this request to node 300/9. Since no other method was
  4693.      specified, it will default to normal and generate a ".FLO" file for
  4694.      the request (as well as a .REQ file).  This transfer will take place
  4695.      at national mail hour.
  4696.  
  4697. EchoUtil /GET echo308.arc from 300/9 C
  4698.  
  4699.  
  4700.  
  4701.  
  4702.                                   Page 72
  4703.  
  4704.  
  4705. EchoDor Version 3.11
  4706. 3/16/92
  4707.  
  4708.      Like the above example, this will request the file "ECHO308.ARC" from
  4709.      300/9, but it will generate a ".CLO" file instead of a ".FLO" file.
  4710.      Therefore, this transfer will take place at the soonest available
  4711.      time.
  4712.  
  4713. EchoUtil /GET ECHODOR from 300/9 H
  4714.  
  4715.      This example demonstrates a "magic" request. Magic requests are
  4716.      special type of request where you specify a magic file name (in this
  4717.      case, "ECHODOR"). The file must be set up as a magic file on the
  4718.      receivers end as well.  The advantage to a magic filename is that the
  4719.      sysop usually has it reference the most recent version of the file you
  4720.      are requesting -- that means you don't have to worry about the exact
  4721.      version number/filename. The "H" on the line specifies that the
  4722.      request will be marked as hold-for-pickup.  The request will not be
  4723.      sent out at all and the remote system must call your system for the
  4724.      request to be processed.  (This is not usually done).
  4725.  
  4726. EchoDor can also do file requests with net mail.  To enable this feature
  4727. set the 'F' flag on your net mail description line within the area
  4728. description table to 'Y'.  Each time you enter a message in the net mail
  4729. area, EchoDor will ask if you want to do a file attach or file request.  If
  4730. you answer "R", meaning request, EchoDor will prompt you for a file name.
  4731. Enter only the file name and extension of the desired file. EchoDor will
  4732. then precede with the net mail message entry.
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.                                   Page 73
  4765.  
  4766.  
  4767. EchoDor Version 3.11
  4768. 3/16/92
  4769.  
  4770.  
  4771. File-attaches
  4772.  
  4773. A file attach is a method of sending a file from your system to any remote
  4774. system.  It is very similar to the file-request feature in operation, but
  4775. no .REQ file is generated. Instead, the filename and path is placed in the
  4776. FLO/CLO/DLO/HLO file.
  4777.  
  4778. EchoUtil generates file-requests with the "/SEND" command line option. The
  4779. syntax is very similar to file-attaching with a few differences shown in
  4780. the examples below.
  4781.  
  4782. Examples:
  4783.  
  4784. EchoUtil /SEND c:\files\echo308.arc to 300/9
  4785.  
  4786.      This sends the file echo308.arc to node 300/9. The file will be
  4787.      defaulted to normal (.FLO) and sent at national mail hour.  The file
  4788.      to be sent (Echo305.arc) is located in the C:\Files directory.  This
  4789.      an important difference from File-requesting -- With a file-attach,
  4790.      you MUST specify the full path of the file.
  4791.  
  4792. EchoUtil /SEND c:\files\echo308.arc to 300/9 C
  4793.  
  4794.      This is the same as the above option except the mail will be set to
  4795.      crash-mail (.CLO) and sent at the first available time.
  4796.  
  4797.  
  4798. EchoDor can also do file attaches with net mail.  To enable this feature
  4799. set the 'F' flag on your net mail description line within the area
  4800. description table to 'Y'.  Each time you enter a message in the net mail
  4801. area, EchoDor will ask if you want to do a file attach or file request.  If
  4802. you answer "A", meaning attach, EchoDor will prompt you for a file name.
  4803. Be sure to enter a fully qualified path name (include the drive and
  4804. directory).  EchoDor will check for the existence of the file and if found
  4805. will continue with the entry of the message.
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.                                   Page 74
  4827.  
  4828.  
  4829. EchoDor Version 3.11
  4830. 3/16/92
  4831.  
  4832. Listing file-requests and file-attaches
  4833.  
  4834. EchoUtil has the capability to produce a summary of all of your file
  4835. requests or attaches that are presently in your outbound directory.
  4836.  
  4837. Note:
  4838.      This will only with with "BINKLEY" type systems.
  4839.  
  4840. To produce a list of current outbound file-requests:
  4841.  
  4842. EchoUtil /REQLIST [INTO <filename>|PRINTER]
  4843.  
  4844.      The INTO parameter is optional and if specified will allow you to send
  4845.      the list to either the printer or a disk-file.
  4846.  
  4847. To produce a list of all outbound file-attaches:
  4848.  
  4849. EchoUtil /ATTACHLIST [INTO <filename>|PRINTER]
  4850.  
  4851.      The INTO parameter functions the same as above. upon the execution of
  4852.      this command, EchoUtil will list all of the file-attaches excluding
  4853.      normal ArcMail packets (.MOx Files).
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.                                   Page 75
  4889.  
  4890.  
  4891. EchoDor Version 3.11
  4892. 3/16/92
  4893.  
  4894.  
  4895. Auto Messages
  4896.  
  4897. The "auto message" ability of EchoDor is a very powerful feature that
  4898. allows you to post news updates about your system in a special area.  When
  4899. a user calls your system, all of the "auto messages" that he has not read
  4900. will be displayed to him.  EchoDor will still honor private messages.  If
  4901. the message is set private then only that user (and any sysop) will see the
  4902. message.  Since the "auto message" area is treated by EchoDor as a normal
  4903. mail area, it is very simple to enter "auto messages".
  4904.  
  4905. To set up an auto message area, simply create a directory like you would
  4906. for any other mail area.  Then, add an entry to EchoDor's area table for
  4907. the auto message area.  The entry should be just like a regular message
  4908. area except set it's type to "A" for auto message.  You should also set it
  4909. to sysop-only to prevent your users from posting in it.
  4910.  
  4911. You have two ways to use the "auto message" feature.  The first and
  4912. simplest way is to do nothing.  When the user enters EchoDor, any auto
  4913. messages that the user has not seen will be displayed to him/her.
  4914.  
  4915. The second way requires you to set your BBS to shell out to EchoDor during
  4916. the users logon process, preferably right after he checks his mail.  With
  4917. RBBS you specify EchoDor as the "Door Program to check users at logon".
  4918. This is in the "doors setup" section.  You need to call EchoDor with either
  4919. "ECHODOR Node-num /AUTO" or "ECHODOR Node-num /AC" where node-num is the
  4920. same as the node-number use when you call EchoDor as a door. The "/AUTO"
  4921. option will simply display all new "auto messages" and the "/AC" option
  4922. will display all auto messages and then ask the user if he wishes to check
  4923. for new echo mail messages.  This second method allows you to use EchoDor
  4924. to display messages to all users regardless of them entering EchoDor to
  4925. read mail.
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.                                   Page 76
  4951.  
  4952.  
  4953. EchoDor Version 3.11
  4954. 3/16/92
  4955.  
  4956.  
  4957. General information
  4958.  
  4959. 1.   Commands can be stacked (r;123 for read message #123, a;2;r;4;q;a;3
  4960.      switch to area #2, read message 4, quit to main, and switch to area
  4961.      #3).
  4962.  
  4963. 2.   There are 5 command switches:
  4964.  
  4965.      /L load up the door in local mode.
  4966.      /S run the door locally and log in the sysop.
  4967.      /H get help about the switches.
  4968.      /R return to running EchoDor
  4969.  
  4970. 3.   The system will check for loss of carrier and out of time.  If either
  4971.      condition occurs, EchoDor will return back to your BBS.  All user
  4972.      information will be saved before exiting.
  4973.  
  4974. 4.   A user will not be kicked off due to time in the middle of a message.
  4975.  
  4976. 5.   You should only log on for a maximum of 120 minutes at a time.  You
  4977.      might be able to log on longer, but the elapsed time functions might
  4978.      have some trouble.
  4979.  
  4980. 6.   You MUST have a fossil driver to run this door, I suggest X00, but
  4981.      OpusCom or BNU should work just as well.
  4982.  
  4983. 7.   If you run net mail you must provide a version 6 nodelist.  The
  4984.      nodelist must be compiled with zone information.  If you use Parselst
  4985.      be sure to include the "UseZones" command.
  4986.  
  4987.      Starting with v3.10a of EchoDor, registered users can use the new
  4988.      EchoDor format nodelist.  This format is most useful for people that
  4989.      run Front Door or D'Bridge.  This new format uses index files and the
  4990.      "raw" nodelist files.
  4991.  
  4992. 8.   Messages with more than 512 lines will be truncated by EchoDor.
  4993.  
  4994. 9.   Messages larger than 32K will be truncated by EchoDor.
  4995.  
  4996. 10.  Message areas may not contain more than 5000 messages.  Areas with
  4997.      more than 5000 messages will lose their last message pointers when
  4998.      renumbered.
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.                                   Page 77
  5013.  
  5014.  
  5015. EchoDor Version 3.11
  5016. 3/16/92
  5017.  
  5018.  
  5019. EchoUser Program
  5020.  
  5021. The EchoUser program allows modification of special control information
  5022. used by EchoDor.  The EchoUser program uses the same DoorDriv.Ctl and
  5023. EchoDor.Ctl file as EchoDor and may be run remote (through the modem).
  5024.  
  5025.  
  5026. User File Records
  5027.  
  5028. The EchoDor user file contains two different types of records.
  5029.  
  5030. Default User & Maintenance Record
  5031.  
  5032. The first record in the file is called the Default User & Maintenance
  5033. record.  The record contains information used by EchoDor when setting up
  5034. new users.  Note that changing fields in the Default User & Maintenance
  5035. record will not alter currently active users.
  5036.  
  5037. The following fields are important during new user setup:
  5038.  
  5039. Graphics Mode
  5040.      Some BBS systems do not pass graphics information to EchoDor that
  5041.      works properly.  This will cause some users to get garbage on their
  5042.      screens.  If the default Graphics mode (Graphics in the Default
  5043.      record) is set to some value other than default, that value will
  5044.      override the value that is passed by the BBS.  You can then instruct
  5045.      the users to set their graphics level from the user menu.
  5046.  
  5047. Default Hot keys
  5048.      Some sysops like hot keys some do not.  The value that is set for hot
  5049.      keys in the Default record will be the value that every new user
  5050.      receives.  This value can be overridden by the user from the user
  5051.      menu.
  5052.  
  5053. Restrict Message Areas
  5054.      This is one of the most powerful features in the EchoDor / EchoUser
  5055.      system.  EchoDor normally controls access to different areas based on
  5056.      the users security level.  In many cases this method is adequate.
  5057.      However, some sysops run special areas for their users.  Using the
  5058.      Restrict Message Areas, access to specific areas can be "Blocked".
  5059.      Every new user will then be excluded from the "blocked" areas.  The
  5060.      "Blocked" will be as if they did not exist.  There is no indication
  5061.      given to the user that a blocked area is any different from a non
  5062.      existent area.
  5063.  
  5064. Sysop Flag
  5065.      The sysop flag cannot be altered in the Default User & Maintenance
  5066.      record.  New users will only be set to SYSOP if their name is in the
  5067.      EchoDor.Ctl file.
  5068.  
  5069. Security Level
  5070.  
  5071.  
  5072.  
  5073.  
  5074.                                   Page 78
  5075.  
  5076.  
  5077. EchoDor Version 3.11
  5078. 3/16/92
  5079.  
  5080.      Some BBS systems do not pass a security level to EchoDor, as an
  5081.      example PC-Board will not pass a security level.  By default EchoDor
  5082.      uses the level 50 for these types of systems.  In most cases this will
  5083.      work fine; however, cases may arise where it would be better to use a
  5084.      different security when users first use EchoDor.  If the security
  5085.      level in the Default record is set, that level will be used in place
  5086.      of the BBS passed level.
  5087.  
  5088. Delete/Undelete
  5089.      The delete/undelete flag cannot be changed in the Default User &
  5090.      Maintenance record.  This record can never be deleted.
  5091.  
  5092. The Default User & Maintenance record also contains a Date Last On.  This
  5093. field is actually the last date when maintenance (EchoUtil /M or EchoUtil
  5094. /MAINT) was run.
  5095.  
  5096. User Records
  5097.  
  5098. All other records in the User file are regular user records.  Using
  5099. EchoUser you can set specific access rights for individual users.
  5100.  
  5101. Graphics Mode
  5102.      Normally you will not want to alter the value in this field for
  5103.      specific users.  Users can set this from the User Menu within EchoDor.
  5104.      Altering this field will override the graphics information passed in
  5105.      the Door Information file.
  5106.  
  5107. Default Hot keys
  5108.      Again, this is a user controlled field and you will not normally want
  5109.      to alter this for individual users.
  5110.  
  5111. Restrict Message Areas
  5112.      Like using this in the Default User & Maintenance record, you can
  5113.      "Block" or "Avail" (available) areas to specific users.  If an area is
  5114.      "Block", that user will not have any idea that the area exists.
  5115.  
  5116. Sysop Flag
  5117.      Sysops can be indicated by having their name in the EchoDor.Ctl file.
  5118.      Adding and deleting sysops in this way can become bothersome.  The
  5119.      SYSOP flag in a user record can be set to have EchoDor treat this user
  5120.      like a sysop.
  5121.  
  5122. Security Level
  5123.      If the Security level for an individual user is set, that security
  5124.      level will be used in place of the security level passed by the BBS.
  5125.  
  5126.      Another user for this, involves SYSOPS.  When a sysop logs on locally
  5127.      into EchoDor using the /S option, EchoDor defines a default security
  5128.      level of 1024 for that user.  This security level may not be high
  5129.      enough for some setups.  To override this 1024 value, enter a security
  5130.      level for the sysop that is adequate.
  5131.  
  5132. Delete/Undelete
  5133.  
  5134.  
  5135.  
  5136.                                   Page 79
  5137.  
  5138.  
  5139. EchoDor Version 3.11
  5140. 3/16/92
  5141.  
  5142.      The Delete/Undelete section is actually two specific functions.  User
  5143.      records in the EchoDor user file can be marked as deleted.  When a
  5144.      user is marked as deleted, that user record will NEVER be deleted by
  5145.      EchoUtil.  Anytime that user attempts to use EchoDor, he will be
  5146.      denied access to the door.
  5147.  
  5148.      The Undelete question will be asked if the user is deleted.  If the
  5149.      Undelete questions is answered Y, that user will be returned to a
  5150.      normal user.
  5151.  
  5152.      The NoDelete function is different from the UnDelete question.  If a
  5153.      user is marked NoDelete, that user will NEVER be deleted by EchoUtil,
  5154.      and will always have access to the Door.
  5155.  
  5156. The last selection on the Menu is the User Record Selection section.
  5157. Before you can change information in a user record or in the Default User &
  5158. Maintenance record, the record to be changed must be selected.
  5159.  
  5160. When selecting the record, you first enter a name (or partial name) of the
  5161. user that you want to change.  For the Default User & Maintenance record,
  5162. enter DEFAULT.  EchoUser will then present you with a list of users that
  5163. match.  The names will be preceded by a user number.  EchoUser will then
  5164. ask for the user number to change.  Enter the desired number of the user.
  5165. Then make the needed changes.
  5166.  
  5167. There is no need to save the changes as this is performed by EchoUser when
  5168. you either change users or exit the program.
  5169.  
  5170.  
  5171. Remote Operation
  5172.  
  5173. EchoUser can be run through the modem.  The command line to run EchoUser
  5174. is:
  5175.  
  5176.      EchoUser %1
  5177.                ^
  5178.                |
  5179.                +  This is replaced with the node number.
  5180.  
  5181. This is exactly the same way used for EchoDor.
  5182.  
  5183. Local Operation
  5184.  
  5185. To run EchoUser locally use the command line:
  5186.  
  5187.      EchoUser /S
  5188.  
  5189. Which will start EchoUser with the SYSOP as fast logon.
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.                                   Page 80
  5199.  
  5200.  
  5201. EchoDor Version 3.11
  5202. 3/16/92
  5203.  
  5204.  
  5205. Using SCANMRG
  5206.  
  5207. The SCANMRG program is used to combine scan logs generated by EchoDor.  A
  5208. scan log is a list of area names which contain new messages.  Normally,
  5209. EchoDor generates a scan log file.  That file is then processed by a mail
  5210. scanner program and outgoing packets are generated.
  5211.  
  5212. However, some people only want to run the scanner program once a day.
  5213. Other people run multiple nodes and only run the scanner from a single
  5214. node.  People that run their boards in this manner need a way to combine
  5215. scan logs.  That is exactly what ScanMrg does.
  5216.  
  5217. The first question you may ask is why not just use copy and append each log
  5218. to the end of a common file.  Ideally if every area was only used once this
  5219. would work.  But, through out the day people will enter multiple messages
  5220. in the same area.  In these cases you want to have that area only listed
  5221. once.
  5222.  
  5223. That is the way SCANMRG works.  First SCANMRG reads the output scan log
  5224. into memory.  Then it reads each line of the input scan log and compares
  5225. the just read area name with all the other area names.  If the name is new
  5226. SCANMRG adds it to the list.  If it is already in the list, SCANMRG
  5227. discards the entry.  When the last entry from the input file is read, all
  5228. the entries are written to the output file.
  5229.  
  5230. The format to use SCANMRG is:
  5231.  
  5232.      SCANMRG infile outfile
  5233.  
  5234.      Where "infile" is the just created input file.
  5235.  
  5236.      And "outfile" is the combined scan logs.  If SCANMRG is run and the
  5237.      "outfile" does not exist, one is created.
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.                                   Page 81
  5261.  
  5262.  
  5263. EchoDor Version 3.11
  5264. 3/16/92
  5265.  
  5266.  
  5267. The EchoDor Nodelist compiler
  5268.  
  5269. Starting with version 3.10a, EchoDor now allows the use of two different
  5270. types of node lists.  The first type of node list is known as a version 6
  5271. node list.  This node list is most often used with BinkleyTerm mailers.
  5272. The second type of node list is exclusive to EchoDor.  This node list uses
  5273. the St. Louis node list and three index files to allow rapid access to
  5274. entries in the node list.
  5275.  
  5276. This new node list is ideal for people who use Front Door or D'Bridge which
  5277. have proprietary node list structures.  During a test the index files for a
  5278. full Fidonet node list took only 180k plus the size of the "raw" St. Louis
  5279. node list.  This is much smaller than the 1 to 2 megabyte files created
  5280. when a version 6 node list is used.
  5281.  
  5282. The node list compiler can not apply node diff files.  You must use a
  5283. separate program to apply the diff's.
  5284.  
  5285.  
  5286. How it works
  5287.  
  5288. The idea is based on doing a single line compile of the "raw" node list
  5289. when that line is needed.  The only real problem with this is finding the
  5290. correct line to compile.  The correct line is located by EchoDor through
  5291. the use of three files.
  5292.  
  5293. The first file is the EchoDIdx.Idx file.  The structure of this file is
  5294. exactly the same as the NodeList.Idx file used in a version 6 node list.
  5295. This file contains all the net/node numbers that are in all the node lists
  5296. with special coding for zones and regions.  The position of the desired
  5297. net/node number within this file allows EchoDor to locate the positional
  5298. information in the next file.
  5299.  
  5300. The positional information is used to read a specific record from the
  5301. second index file.  This is the EchoDXId.Idx file.  This file contains the
  5302. full zone, net, and node number as well as the node's hub.  Also, two other
  5303. very important pieces of information is contained in the file.  They are
  5304. the file number and the line position.
  5305.  
  5306. The file number is used to locate the name of the "raw" node list file
  5307. within the third file called EchoDNLx.Idx.  This file is only used when the
  5308. node list file must be switched.  The line position is then used to read a
  5309. single line of information from the "raw" node list file.
  5310.  
  5311. The single line of information from the "raw" node list is them compiled by
  5312. EchoDor "on the fly".
  5313.  
  5314. Even though the above procedure sounds very slow,  EchoDor is able to
  5315. perform the operations quiet rapidly.  You will notice very little
  5316. difference between the speed of a version 6 node list and the new EchoDor
  5317. node list indexing system.  What you will notice is a lot of disk space
  5318. available that wasn't there before.
  5319.  
  5320. The Control file
  5321.  
  5322.                                   Page 82
  5323.  
  5324.  
  5325. EchoDor Version 3.11
  5326. 3/16/92
  5327.  
  5328.  
  5329. The control file directs EchoNLCP to the node lists that are to be compiled
  5330. and the directory that is to contain the index files.  The following
  5331. commands are valid in the EchoNLCP.CTL file:
  5332.  
  5333. DIRECTORY <directory name>
  5334.  
  5335.      This is the directory where the three index files (ECHODIDX.IDX,
  5336.      ECHODXID.IDX, and ECHODNLX.IDX) are to be placed.  This file does not
  5337.      have to be in the EchoDor directory nor does it have to be in the same
  5338.      directory as the St. Louis ("raw") node lists.
  5339.  
  5340.      The <directory name> must match the NODELISTPATH parameter in the
  5341.      EchoDor.Ctl file.
  5342.  
  5343.      There can be only one DIRECTORY parameter.
  5344.  
  5345. NODELIST <Drive:\Path\Nodelist.fil>
  5346.  
  5347.      This parameter tells EchoNLCP where to find the node list to be
  5348.      compiled.  The drive and path are optional; however, you should not
  5349.      use "relative" directories (such as . (dot) and .. (dot, dot)).
  5350.  
  5351.      If the nodelist file is specified using a wild card, such as
  5352.      NODELIST.*, EchoNLCP will check all occurrences and compile the most
  5353.      recent one.  Be careful that it doesn't pick up a file that is not a
  5354.      node list file.  EchoNLCP will never attempt to compile a file that
  5355.      has an extension of DAT, FDX or IDX.
  5356.  
  5357.      You can specify as many NODELIST lines as needed to compile all the
  5358.      node lists you use.  The node list files do not all have to be in the
  5359.      same directory.
  5360.  
  5361. NODELISTTYPE <V6>
  5362. NODELISTTYPE <ED>
  5363.  
  5364.      This parameter is not really used by EchoNLCP, but is used by
  5365.      EchoNLRD.  This tells EchoNLRD which type of node list it should be
  5366.      trying to read.  The default is ED for EchoNLCP type node lists.  The
  5367.      V6 will allow EchoNLRD to read a version 6 node list.
  5368.  
  5369.  
  5370. Running EchoNLCP
  5371.  
  5372. EchoNLCP must be run anytime a change is made to any of the node list files
  5373. specified in the control file.
  5374.  
  5375. EchoNLCP cannot apply node diff files.
  5376.  
  5377. The command line to run EchoNLCP is:
  5378.  
  5379.      EchoNLCP
  5380.  
  5381.      or
  5382.  
  5383.  
  5384.                                   Page 83
  5385.  
  5386.  
  5387. EchoDor Version 3.11
  5388. 3/16/92
  5389.  
  5390.      EchoNLCP cntlfile.ctl
  5391.  
  5392. The "cntlfile.ctl" file specification is optional.  If not specified
  5393. EchoNLCP will look in the current directory for a file named EchoNLCP.CTL.
  5394.  
  5395. Operation of the compiler is very fast.
  5396.  
  5397.  
  5398. EchoNLRD node list reader
  5399.  
  5400. I have include a little utility which will allow you to read node list
  5401. information from the node list indexes generated by EchoNLCP.  This is a
  5402. good check to see if all is OK as well as a "quickly" node list look up
  5403. utility.
  5404.  
  5405. To run EchoNLRD, go to the directory where the EchoNLCP.CTL file is located
  5406. and type EchoNLRD.
  5407.  
  5408. If you are not in the directory where then EchoNLCP.CTL file is located
  5409. type EchoNLRD Drive:\Path\EchoNLCP.CTL.  This will start the reader and
  5410. tell it the file to use as a control file.
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.                                   Page 84
  5447.  
  5448.  
  5449. EchoDor Version 3.11
  5450. 3/16/92
  5451.  
  5452.  
  5453. Opus 1.1x Converter (OPUSCNVT)
  5454.  
  5455. This program is used to convert information in Opus SYSTEM##.DAT files to a
  5456. format usable by EchoDor.  This utility takes two command line parameters.
  5457. The first is the directory where OPUSCNVT can find the SYSTEM##.DAT files.
  5458. The second parameter is the file that should be created by OPUSCNVT.  For
  5459. Example:
  5460.  
  5461.      OPUSCNVT C:\OPUS C:\EchoDor\Areatab.Txt
  5462.  
  5463. In the above example, OPUSCNVT will search the directory "C:\OPUS" for all
  5464. SYSTEM##.DAT files.  After all the information is collected from the files,
  5465. OPUSCNVT will write a file called Areatab.Txt in the directory C:\EchoDor.
  5466. This file will only contain AREATABLE & AREADESC entries.
  5467.  
  5468. The following rules/exceptions are followed by OPUSCNVT:
  5469.  
  5470. If a SYSTEM00.DAT file exists it will be skipped.
  5471.  
  5472. All local areas will have a listed tag and an echo name of "Local".
  5473.  
  5474. All Net Mail areas will have a listed tag and an echo name of "Net mail".
  5475.  
  5476. The "No Public" flag is ignored.
  5477.  
  5478. If there is no separate write priv in the Opus area, Read Priv will be used
  5479. for WRACC.
  5480.  
  5481. File request will always be set "N".
  5482.  
  5483.  
  5484. After running OPUSCNVT you will edit your EchoDor.Ctl file.  You would
  5485. insert a line something like:
  5486.  
  5487.      INCLUDE C:\EchoDor\AreaTab.Txt
  5488.  
  5489. This would eliminate the need for you to transfer the information from the
  5490. created file to the EchoDor.Ctl file.
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.  
  5499.  
  5500.  
  5501.  
  5502.  
  5503.  
  5504.  
  5505.  
  5506.  
  5507.  
  5508.                                   Page 85
  5509.  
  5510.  
  5511. EchoDor Version 3.11
  5512. 3/16/92
  5513.  
  5514.  
  5515. Support for EchoDor
  5516.  
  5517. For support and registration you can reach me at:
  5518.  
  5519.      Robert McCullough
  5520.      P.O. Box 101095
  5521.      Nashville, TN  37224
  5522.      Voice Number 615 256-2444
  5523.  
  5524. BBS Support is available from:
  5525.  
  5526.      The WorkBench BBS
  5527.      Fidonet Node 1:116/1000.0
  5528.      Rbbsnet Node 8:967/107.0
  5529.      Nashville, TN  37210
  5530.  
  5531.      The BBS Number is 615 256-2211
  5532.      Available 23 hours a day.
  5533.      9600 Hst
  5534.  
  5535.      Note: We may be moving soon.  We will still be in Nashville.  Check
  5536. the node list for the correct number to use.
  5537.  
  5538. For registration and support in Europe you can call:
  5539.  
  5540.      Chris Pelling
  5541.      84 Heathcote Dr
  5542.      East Grinstead
  5543.      West Sussex
  5544.      RH19 1ND
  5545.      ENGLAND
  5546.  
  5547. BBS support in Europe is available from:
  5548.  
  5549.      SDS Data Design's IBM BBS
  5550.      Fidonet Node 2:254/41.0
  5551.      Available 8pm-8am GMT
  5552.      9600 Hst/DS/V42bis
  5553.      011 +44 342 317 976
  5554.  
  5555. Information about EchoDor is also available in the National conference
  5556. ECHODOR.  I understand that the conference is available on the Fidonet
  5557. backbone and the RBBSNet area.  Please check with your net's National Echo
  5558. Mail Coordinator about the availability of this echo.
  5559.  
  5560. If you want to register EchoDor, please see the REGISTER.DOC file contained
  5561. in this archive.
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.  
  5570.                                   Page 86
  5571.  
  5572.  
  5573. EchoDor Version 3.11
  5574. 3/16/92
  5575.  
  5576.  
  5577. Revision History
  5578.  
  5579.  
  5580. 3.11 revisions
  5581.  
  5582. EchoDor will now do a Confirm on [S]ave.
  5583.  
  5584. ^A, SEEN-BY, and PATH lines were getting wrapped when using a MAXLINELENGTH
  5585. command.  This has been corrected; however, ^A, SEEN-BY, and PATH lines
  5586. will always be displayed as full 72 character lines.
  5587.  
  5588. A problem was found in EchoNLCP causing it to skip nodes (yep, I finally
  5589. found a problem).  This has hopefully corrected the problem.
  5590.  
  5591. Corrected a problem in EDorPurg that caused it to lose the high message
  5592. pointer in message #1 in echo areas.
  5593.  
  5594. Main menu can now do area "select".  This includes changing areas by
  5595. number, and special commands <, +, -, >.  You can not "select" an area by
  5596. name from the main menu, to select by name you must still use the [A] or
  5597. [J] command.
  5598.  
  5599. Comment area will now default to "PRIVATE" if the area allows private
  5600. message entry.  To enable private messages in the comment area, set the "P"
  5601. flag in the AreaDesc table to Y.
  5602.  
  5603. Hopefully the problem with ^Z and ^A not working in the visual editor from
  5604. the remote end had been fixed.
  5605.  
  5606. EchoDor now does NOT include SOFT CR's (0x8d) in the message by default.
  5607. If you want EchoDor to include SOFT CR's in the message, add USESOFTCR to
  5608. the EchoDor.Ctl file.
  5609.  
  5610. Hot keys didn't work on the help prompt.
  5611.  
  5612. A request was made to "highlight" the one line menus.  This has been done
  5613. so that users will have a better idea of what to do.
  5614.  
  5615. If you used the "restrict" option in the EchoUser program, it would not
  5616. restrict the user you were working on, but would restrict the logged on
  5617. user (the sysop).
  5618.  
  5619. EchoUser has new options.  These include "Global restrict" and "Clear
  5620. Message area".  Read the documentation for an explination of these options.
  5621.  
  5622. The "Command string" area was origionally limited to 40 characters.  This
  5623. has been expanded to 80 characters.  This will allow you to put more
  5624. information into the command string.
  5625.  
  5626. New EchoDor control option, VisualEsc.  This allows you to define
  5627. characters (such as period (.) or slash (/)) which when typed in column 1
  5628. on the visual screen, will act the same as an esc.  Makes Visual editor
  5629. even easer to use.
  5630.  
  5631.  
  5632.                                   Page 87
  5633.  
  5634.  
  5635. EchoDor Version 3.11
  5636. 3/16/92
  5637.  
  5638.      If you want to use this add a line something like:
  5639.  
  5640.          VISUALESC ./\
  5641.  
  5642.      to the EchoDor.Ctl file.  The three characters, period (.), slash (/)
  5643.      and back slash (\) will if typed in column 1 act exactly was if the
  5644.      user pressed the ESC key.
  5645.  
  5646. I have separated the [I]gnore sections for packing mail and for reading
  5647. messages.  This will allow a user to have one setup for reading mail and
  5648. one setup for packing mail.  For example, let's say there is a local echo
  5649. that the user reads and the traffic is small.  The user can put that echo
  5650. in the [I]gnore option from the [U]ser setup menu.  Then the user can go to
  5651. the [P]ack section and [I]gnore all ares except what he wants to pack if he
  5652. selects the Pack All Areas option.
  5653.  
  5654. The [I]gnore system can now except multiple numbers on the Activate area
  5655. and the Ignore area prompts.  Multiple numbers are separated by spaces.
  5656.  
  5657. Removed the NOTIME parameter from the EchoDor.Ctl file.  This parameter is
  5658. now available in the DoorDriv.Ctl file.
  5659.  
  5660. The registration of EchoDor is now controlled by a KEY file.  If this file
  5661. is not present, EchoDor will beep and display the "Not registered" screen.
  5662. I have done this to make it easer for registered users to upgrade.  Once
  5663. the EchoDor.Key file is in place, you won't have to get a new copy from me
  5664. ... just copy the stuff into the directory and it will work registered.
  5665.  
  5666. Fixed a minor problem which would sometimes cause EchoDor to exit with an
  5667. error 005 if a user went into echodor then immediately exited.
  5668.  
  5669. Fixed the HCopy problem which would cause EchoDor to "lock up" if HCopy was
  5670. selected and you didn't have a printer attached to the computer or some
  5671. printer problem occured.  EchoDor now writes to the printer using BIOS
  5672. calls and can detect if the printer goes off line or malfunctions.
  5673.  
  5674. I've reduced the memory requirements of EchoDor by using Overlays.  I have
  5675. structured the overlays so that you should not see any loss of operating
  5676. speed.  The current memory requirements of EchoDor is now 303k.  Warning:
  5677. don't try to compress EchoDor with LZEXE or PKLite.  It probally won't
  5678. work!!!
  5679.  
  5680. Fixed a problem which caused EchoDor to not go online when the sysop used
  5681. the DOOR.SYS (WC3.0 or GAP) drop file.
  5682.  
  5683. Improved the carrier detection scheme used in EchoDor.  In older versions
  5684. if the user was displaying a large screen and the fossil didn't have enough
  5685. buffer to hold the entire file and the user dropped carrier, EchoDor would
  5686. hang.  This has hopefully been corrected.
  5687.  
  5688. There was a problem when specifying a starting message number when packing
  5689. or scanning mail.  EchoDor would always start on the message following the
  5690. specified number.  This problem has been corrected.
  5691.  
  5692.  
  5693.  
  5694.                                   Page 88
  5695.  
  5696.  
  5697. EchoDor Version 3.11
  5698. 3/16/92
  5699.  
  5700. EchoDor can now swap itself out of memory when it does a "shell to dos".
  5701. To enable this feature add the parameter "SWAPFILENAME" to the DOORDRIV.CTL
  5702. file. Be sure to read the documentaton on this feature before you use it.
  5703. If swapping is enabled, memory requirements for EchoDor when you drop to
  5704. DOS is about 15k.
  5705.  
  5706. It has been requested to allow the SYSOP to configure the chat colors used.
  5707. Two new parameters in the DOORDRIV.CTL file will now allow you to configure
  5708. the colors used for chat.  These are CHATUSERCOLOR and CHATSYSOPCOLOR.
  5709.  
  5710. EchoDor can now be told to reconize the GT embedded message codes.  These
  5711. are ^E (pause then non-stop), ^R (non-stop), ^T (disable abort).  The ^T
  5712. actually produces no action within EchoDor.  To "turn on" this feature put
  5713. a G in the "P" column of the area table.  The P column is becomming more
  5714. the type of messages allowed and less just a "private" flag.
  5715.  
  5716. EchoDor can now play music if it's embedded in the message.  This will be
  5717. most useful when using ANSI GT messages.
  5718.  
  5719. It appears that some LANs have problem when files are opened in compability
  5720. mode on the network.  I have made changes in EchoDor which will hopefully
  5721. improve LAN compability.
  5722.  
  5723. Problems were found using the Alias functions.  EchoDor would not ask if
  5724. the user wanted to use an alias name during message entry.  Also, sometimes
  5725. when the alias name was set, problems occured in the user menu.
  5726.  
  5727. When displaying a area list from the AreaDesc area (not from a file), the
  5728. "More ?" prompt would not allow the user to stop the entry.  The "More ?"
  5729. prompt has been replaced with a "Continue Y/n ?" prompt which will allow
  5730. the user to stop the display.
  5731.  
  5732. When specifying areas to be [I]gnored, EchoDor would only allow a maximum
  5733. of 10 entries to be specified at one time.  Some users were putting in long
  5734. lists of area numbers which would cause all entries beyond the 10th entry
  5735. to be skipped.  This problem has been corrected.  EchoDor will now allow as
  5736. many entries as the user specifies.  I have also added a special entry
  5737. 'ALL'. If the user enters ALL, every area will either be ignored or
  5738. activated depending on which one the user selected.
  5739.  
  5740. I found a problem in EDorPurg which would allow it to become confused while
  5741. relinking messages.  This would be caused by a message that was incorrectly
  5742. linked (7 > 10 > 5) or (15 < 20 < 12) or (15 < 15).  I have put extra
  5743. checking into EDorPurg which will cause it to break out of the link loop
  5744. should this type of condition occur.
  5745.  
  5746. When EchoDor recorded the number of times read, it would change the
  5747. date/time stamp of the message file.  This would cause no problem unless
  5748. you tried to use the FDAYS option on EDorPurg.  EchoDor will now preserve
  5749. the date/time stamp of the message file when updating the times read and
  5750. received bits.
  5751.  
  5752. The [U]ser List option in the User Maintenance routine has been changed to
  5753. [L]ist User file.  The [U] option is now used for [U]pload Protocol.
  5754.  
  5755.  
  5756.                                   Page 89
  5757.  
  5758.  
  5759. EchoDor Version 3.11
  5760. 3/16/92
  5761.  
  5762. EchoDor now allows a user to upload a message.  If the proper parameters
  5763. are specified in the EchoDor.Ctl file, EchoDor will ask the user if they
  5764. wist to upload a message.  If they respond "Y", EchoDor will present the
  5765. protocols listed in the UPLOADFILE.  It will then "switch" to the upload
  5766. and being the upload.  When the upload is completed, EchoDor will import
  5767. the message (using word wrap mode), then switch to the editor so the user
  5768. can "taylor" the just uploaded message.  The name of the file used for the
  5769. upload is not important
  5770. as EchoDor will import the first file it finds in the upload directory.
  5771.  
  5772. If a user was running a multiple zone setup, it became necessary to always
  5773. insert zone information in every message going out from EchoDor.  EchoDor
  5774. will now watch for a multiple zone setup, if one is detected, EchoDor will
  5775. place an ^AINTL line in every net mail message.  This function can also be
  5776. forced with a FORCEZONE command in the EchoDor.Ctl file.
  5777.  
  5778.  
  5779. 3.10a revisions (we didn't release a 3.10):
  5780.  
  5781. When using EchoDor Nodelists, would not show the hub address.
  5782.  
  5783. Now does times read.  This feature is integrated into the renumber/purge
  5784. utility so that it can tell you if an area has had NO activity.
  5785.  
  5786. Fixed, INCLUDE/EXCLUDE in EchoNLCP.
  5787.  
  5788. EchoNLRD can now read V6 node lists.
  5789.  
  5790. In some cases the NodeList search could go into a loop. Fixed.
  5791.  
  5792. When sending file attaches, EchoDor would only allow one file to be sent.
  5793. Now EchoDor will do a file search when using wildcards and will allow
  5794. multiple files to be specified.  The length of the area that allows
  5795. specification has been increased to the full 72 characters.  Also when
  5796. EchoDor did a file attach, the file name, exactly as entered, was placed in
  5797. the message.  This would sometimes cause the mailer problems if it was in a
  5798. different directory. EchoDor now puts the file name complete with full path
  5799. and drive into the message.
  5800.  
  5801. When doing a message "Copy" EchoDor would say the wrong address, this has
  5802. been corrected.
  5803.  
  5804. After issuing a User or Packmail function you couldn't get the menu back
  5805. except with a question mark (?).  This has been corrected so that if a
  5806. blank or null entry is made the menu will be re displayed.
  5807.  
  5808. If the time ran out during a full screen edit, the local screen went
  5809. strange. This has been corrected.
  5810.  
  5811. When packing or scanning and the user did not select All and EchoDor found
  5812. a private message addressed to the user or from the user or the user was a
  5813. sysop, EchoDor would display/pack the message (whew!) even if it did not
  5814. fit the requested criteria. Anyway, the scanning and packing is fixed so
  5815. they will work as expected.
  5816.  
  5817.  
  5818.                                   Page 90
  5819.  
  5820.  
  5821. EchoDor Version 3.11
  5822. 3/16/92
  5823.  
  5824. Removed the DISPLAY and DISPLAYLN functions from the CONFIG file.  These
  5825. were causing problems with the various programs in EchoDor that have to use
  5826. this feature.  Plus, future versions of EchoDor will not have need of these
  5827. options.
  5828.  
  5829. New read/pack/scan option, Mine.  Allows reading/packing/scanning only
  5830. messages addressed to or from the user.
  5831.  
  5832. The user can now read messages during the scan procedure.  All the user has
  5833. to do is enter the message number he/she wants to read and the message will
  5834. be displayed.  After reading the message, the user can enter a new message,
  5835. reply to the message just read or return to the scan.
  5836.  
  5837. Once a user started packing mail, there was no way to stop it.  Now, if the
  5838. user presses any key, EchoDor will ask if the user wants to stop.
  5839.  
  5840. Fixed overwrite problem by more prompt in help system.
  5841.  
  5842. Removed SYSOP lines from the EchoDor.Ctl file.  This feature is now set
  5843. using the EchoUser program.  If the user is logging on as a SYSOP with the
  5844. /S option, EchoDor will automatically give that person a SYSOP status.
  5845.  
  5846. Added user alias names.  User alias names are automatically activiated when
  5847. one or more of the message bases allows aliases.
  5848.  
  5849. Added the ability to send anonymous messages.
  5850.  
  5851. Added a "MaxLineLength" option in the EchoDor.Ctl file.  This option will
  5852. allow a sysop to force EchoDor to use a shorter line when reading and
  5853. entering messages.  The MaxLineLength range is from 40 - 75.  This option
  5854. is added to compensate for message editors that aren't smart enough to wrap
  5855. a quote.  I sure wish some of the other authors would fix their "brain dead
  5856. editors"!
  5857.  
  5858. Visual edit will now show "Private" when entering a private message.
  5859.  
  5860. Added Read Help file.  Enter "?" for help at the read menu.  This is
  5861. currently (or should be if upgrading) set to EchoHLP4.  This is the help
  5862. file that contains the read information.  This file is set during startup
  5863. by a new EchoDor.Ctl command READHELPFILE.
  5864.  
  5865. When entering a message, EchoDor now allows the message attributes to be
  5866. altered.  These attributes include Private, Crash, Hold, Return Request,
  5867. and Is Return.  The attributes are changed using the Optn function.
  5868.  
  5869. EchoDor will now generate file update requests.  If the netmail area allows
  5870. file requests, EchoDor will now ask File [R]equest / [A]ttach / [U]pdate.
  5871.  
  5872. When an update request is entered, EchoDor will change the name so that a
  5873. fill path name is used.  EchoDor will also prevent wildcards from being
  5874. used with an Update request.
  5875.  
  5876. If EchoDor timed a user out the user record was not being updated.  This
  5877. caused EchoDor to forget the last read pointers in the current area.  This
  5878. has been corrected.
  5879.  
  5880.                                   Page 91
  5881.  
  5882.  
  5883. EchoDor Version 3.11
  5884. 3/16/92
  5885.  
  5886.  
  5887. When doing a message copy or a Xerox, EchoDor didn't clear the replyto and
  5888. next reply numbers.  This would produce a strange effect when moved to a
  5889. different message area.  Also, EchoDor didn't set the local flag.  This is
  5890. corrected.  Finally, if the message was private, that flag wasn't cleared.
  5891.  
  5892. The private flag is now cleared and if the target message area allows
  5893. private messages, EchoDor will ask if the message should be private.
  5894.  
  5895. The Visual Editor has an optional modified quote system.  The old method
  5896. required two quote operations for the user to be able to insert quoted
  5897. lines into the message.  If the new method is used (by placing NEWQUOTE in
  5898. the EchoDor.Ctl file), EchoDor will immediately insert the quoted lines
  5899. into the message ABOVE the cursor when the user exits quote mode.
  5900.  
  5901. EchoDor will now confirm when requesting to "kill" a message.  An
  5902. additional Yes/No question is asked.  This makes hot keys safer.
  5903.  
  5904. EchoDor will now confirm when requesting to "abort" a message after entry.
  5905. An additional Yes/No question is asked.
  5906.  
  5907. If a user is "deleted" using EchoUser, that user will no longer show up in
  5908. the "List user" functions.
  5909.  
  5910. EchoDor has a new read function, this is [F]ile.  This allows a sysop to
  5911. save a message into a named file.  When [F]ile is selected from the read
  5912. menu, EchoDor will request the file name.  If the file already exists,
  5913. EchoDor will ask if you want to overwrite, append, or quit.  If overwrite
  5914. is selected, EchoDor will overwrite the existing contents of the file, if
  5915. append is selected, the message is appended to the end of the file.
  5916.  
  5917. EchoDor would remove lines that began with Area: .. these types of lines
  5918. were generated by RAID.  EchoDor is now smarter at removing lines that have
  5919. "key words" in them such as Area, Path, or SEEN-BY.
  5920.  
  5921. A problem was found in ECHONLCP which would cause it to put an incorrect
  5922. net number in node records when the node record immediately followed a ZONE
  5923. line without a REGION or HOST.  This has been corrected.
  5924.  
  5925. EchoDor now supports Genesis Deluxe, GAP, OPUS 1.7x, and WildCat! version
  5926. 3.0 bbs's.  We no longer support OPUS 1.1x bbs's.
  5927.  
  5928.  
  5929. 3.09 revisions:
  5930.  
  5931. EchoDor now has a "DIRECTVIDEO" option in the DoorDriv.Ctl file.  This will
  5932. allow the sysop to configure EchoDor to either use BIOS writes (comment out
  5933. the DirectVideo line) or direct screen writes (include the DirectVideo
  5934. line).
  5935.  
  5936. A new parameter is now available in the EchoDor.Ctl file, this is the
  5937. "INCLUDE" parameter.  This will be most used by sysops that run multiple
  5938. line systems and want to only maintain one file that contains the AREATABLE
  5939. and the AREADESC sections.
  5940.  
  5941.  
  5942.                                   Page 92
  5943.  
  5944.  
  5945. EchoDor Version 3.11
  5946. 3/16/92
  5947.  
  5948. EchoDor will now allow the SYSOP to configure HotKeys.
  5949.  
  5950. There was a problem in the origin net/node number when generating Echo
  5951. mail.  This problem would cause UUCP not to function correctly with
  5952. messages generated by EchoDor.  This has been corrected and UUCP should
  5953. work with EchoDor now.
  5954.  
  5955. I have included a little utility which will be useful for Opus Sysops that
  5956. want to use EchoDor.  This is the OpusCnvt program.  It will read
  5957. SYSTEM##.DAT files and create a file that contains AREATABLE/ENDAREATABLE &
  5958. AREADESC/ENDAREADESC sections.  If this is used with the INCLUDE option,
  5959. conversion to EchoDor will be very fast.
  5960.  
  5961. Four new functions area available when selecting an area.  These are the
  5962. [+]Next Area, [-]Prior area and the [>]Next Area with messages, [<]Prior
  5963. Area with messages functions.  If the user selects "+", EchoDor will move
  5964. that user to the next area that he/she has set to active.  When selecting
  5965. "-", the user will be moved to the prior area.  If the user selects ">",
  5966. EchoDor will move to the next area that the user has set active which
  5967. contains unread messages.  When selecting "<", EchoDor will move to the
  5968. prior area that the user has set active which contains unread messages.
  5969. Also, when changing areas with the plus and minus, EchoDor will tell you if
  5970. there are new messages in the area.
  5971.  
  5972. EchoDor now has "Hot Keys".  When enabled the menu response is very fast.
  5973. In places where the user might need to type in multiple characters, the
  5974. "hot key" feature is disabled.  I think you'll like this feature.
  5975.  
  5976. I have rewritten the Xerox function.  The old function would only copy the
  5977. current message to the current area.  The new Xerox function will now allow
  5978. the sysop to Xerox the current message to any area.
  5979.  
  5980. I have rewritten the sysop MESSAGE COPY function.  The old function would
  5981. copy a message from any area to the current area.  This would confuse some
  5982. people.  The new MESSAGE COPY function will now allow you to copy a message
  5983. from any area to any area.  The default is now from the current area to
  5984. another area which is the opposite of the old way.
  5985.  
  5986. There was a problem which would cause EchoDor to tell the user "You Don't
  5987. have enough time left" when he actually did.  This problem was due to an
  5988. error in the MINTIME function.  This has hopefully been corrected.
  5989.  
  5990. EchoDor will now tell you when you have exited chat mode.  Prior to 3.09
  5991. you had to guess if you were still in chat after you pressed the ESC key.
  5992.  
  5993. In versions prior to 3.09 the "AutoMessage" function was only available if
  5994. you started EchoDor %1 /AUTO.  Starting with this version, EchoDor will
  5995. always execute the "AutoMessage" function when it starts in normal mode.
  5996. This will allow a sysop to use the "AutoMessage" function without having to
  5997. run EchoDor twice.
  5998.  
  5999. EchoDor now has a [V]iew function available from the read menu.  This
  6000. function is not listed on the read menu but is available to all SYSOPs.
  6001. The function allows a sysop to see all the ^A kludge lines, the SEEN-BYs,
  6002.  
  6003.  
  6004.                                   Page 93
  6005.  
  6006.  
  6007. EchoDor Version 3.11
  6008. 3/16/92
  6009.  
  6010. and the PATH lines.  This is sometimes useful when trying to track where a
  6011. message has come from.
  6012.  
  6013. I have added a new option to the File function when importing files.  This
  6014. function is [F]old lines.  This option will retain the line structure, but
  6015. it will break the lines on word boundaries.  This produces a much better
  6016. appearance than just importing the file.
  6017.  
  6018. When quoting with the full screen editor, EchoDor now removes all ^A,
  6019. SEEN-BY, and PATH lines from the message.  Old versions prevented the user
  6020. from quoting the message but the new version removes the lines.  This gives
  6021. the quote a "cleaner" appearance.
  6022.  
  6023. EchoDor now sets the "received" bit when a message is either read or packed
  6024. by the receiver.  This is also displayed when reading the message and
  6025. scanning the message.  EchoDor also increments the number of "times read"
  6026. counter in the message.  This counter can be used to tell if an area is
  6027. active.
  6028.  
  6029. When a user first entered a message base and the first message was not 1 or
  6030. 2, EchoDor would take a long time to read the first message.  EchoDor now
  6031. keeps both a high message pointer and a low message pointer to an area.
  6032. This allows EchoDor to go immediately to the first message in an area.
  6033. Also, the first message number as displayed in the read menu correctly
  6034. reflects the first real message number.
  6035.  
  6036. The "Pack All Message Areas" question default has been changed from "Y" to
  6037. "N".
  6038.  
  6039. When packing a single area, the starting message number now defaults to the
  6040. last message read plus 1.
  6041.  
  6042. A problem was found which could cause EchoDor to lock up when packing mail
  6043. and the user dropped carrier.  This problem has been corrected.  Now when
  6044. packing mail, if the user drops carrier, EchoDor will exit normally.
  6045.  
  6046. EchoDor no longer contains the NODOORMODE parameter.  When this parameter
  6047. was not present, EchoDor displayed it's name and a closing string when
  6048. exiting.  The extra code has been removed along with the parameter.
  6049.  
  6050. EchoUtil had problems with most of the functions that used the "outbound"
  6051. area.  Hopefully most of these problems have been corrected.
  6052.  
  6053. EchoUtil no longer contains the /SCAN and /DUMP functions.  They have been
  6054. removed because of their size and because these functions are provided in
  6055. EchoDor.
  6056.  
  6057. EchoUtil can now process message areas that contain 5000 messages.  This is
  6058. 3000 more than prior versions.
  6059.  
  6060. If EchoUtil /M was run multiple time, it would increment the check messages
  6061. flag (asking the user to check for private messages) each time it was run.
  6062. This has been corrected.  The counter will only be incremented once per run
  6063. per day.
  6064.  
  6065.  
  6066.                                   Page 94
  6067.  
  6068.  
  6069. EchoDor Version 3.11
  6070. 3/16/92
  6071.  
  6072. EchoUtil now has the /RENUM function.  This will allow resetting the last
  6073. read pointers without deleting old users.
  6074.  
  6075. A problem was found in the EchoNLCP compiler.  It would not write the last
  6076. block to the EchoDXID.IDX file.  This would cause EchoDor not to be able to
  6077. find the last 1000 nodes in the nodelist file.  This problem has been
  6078. corrected.
  6079.  
  6080. EchoNLCP will now skip files that have an extension of DAT, IDX or FDX.
  6081. Node list files must never have this extension.
  6082.  
  6083. EchoNLRD has been enhanced to allow node list searching.  This is identical
  6084. to the operation of the node list option in EchoDor.
  6085.  
  6086. A new program called EchoUser is now available.  This allows you to set
  6087. individual usre's security and access levels as well as more precisely
  6088. control new user access.  This program will run either remote or local.
  6089.  
  6090. 3.08 revisions:
  6091.  
  6092. EchoDor now has new commands in the read menu to allow the user to read a
  6093. thread.  These new commands are plus (+), minus (-), and asterisk (*).
  6094.  
  6095. Users can now enter messages from the Read menu by pressing the letter "E"
  6096. for enter.  Because this was the old EDIT command, the new command to
  6097. replace edit is CHANGE which uses the "C" key.
  6098.  
  6099. The "Doctor" command now understands all the "bits" in a message.  This has
  6100. required some changes in the layout but it should present no problems.
  6101.  
  6102. EchoDor.Ctl file has been slightly altered.  This alteration allows EchoDor
  6103. to load the file more quickly.  See UPDATE.DOC on how to change your file
  6104. to the new format.
  6105.  
  6106. Some commands have also been eliminated from the EchoDor.Ctl file.  These
  6107. commands were duplicates of commands already in the DoorDriv.Ctl file.
  6108. These commands DO effect the display color.  Be sure to read UPDATE.DOC on
  6109. setting new colors.
  6110.  
  6111. New NodeList format.  Starting with 3.08 of EchoDor, a special format
  6112. Nodelist can be used in place of the version 6 nodelist required by prior
  6113. versions.  This new nodelist uses a set of index files to allow use of the
  6114. RAW nodelist file.  This will reduce the amount of disk space required to
  6115. support EchoDor.  (A full nodelist required about 180k plus the raw
  6116. nodelist file). People running FrontDoor and D'Bridge will gain the most
  6117. from this feature.  Note:  Although the unregistered version of EchoDor
  6118. supports this new nodelist format the compiler which is required to
  6119. generate these files is included ONLY IN THE REGISTERED VERSION.
  6120.  
  6121. There are some slight changes in the user interface which should make
  6122. EchoDor easer to use.
  6123.  
  6124. The [P]ack Mail feature now allows the user to select the type of
  6125. compression to use to compress the mail files.
  6126.  
  6127.  
  6128.                                   Page 95
  6129.  
  6130.  
  6131. EchoDor Version 3.11
  6132. 3/16/92
  6133.  
  6134. There were also problems when returning to EchoDor from [P]acking mail.
  6135. These problems have been corrected.
  6136.  
  6137. EchoDor now inserts the new ^AMSGTO: line into outbound messages.
  6138.  
  6139. The number of lines allowed in a message has been increased from 200 to
  6140. 512.
  6141.  
  6142. When displaying a node list entry from the sysop menu, EchoDor now displays
  6143. the baud rate of the BBS.
  6144.  
  6145. EchoDor had a problem displaying node list information which contained a
  6146. password that was 8 characters long.  This has been corrected.
  6147.  
  6148. Long messages would sometime cause EchoDor a run time error.  This has been
  6149. corrected.  Now EchoDor will truncate the message to a maximum of 512
  6150. lines.
  6151.  
  6152. EchoDor would always attempt to verify a user when entering into the local
  6153. message base even if the message wasn't private.  This has been corrected
  6154. so that EchoDor will only verify private messages.
  6155.  
  6156. EchoDor can now import files when entering messages.  This feature is only
  6157. available when running in local mode.
  6158.  
  6159. The "read lock" from value could not be set.  This has been corrected.
  6160.  
  6161. The arrow keys on remote systems should now work correctly.  Prior to
  6162. version 3.08, EchoDor would have problems with the special character keys
  6163. (arrow and such) from slow modems.  This has hopefully been corrected.
  6164.  
  6165. When copying a message EchoDor would not insert the "message copied from"
  6166. information.  This has been corrected.
  6167.  
  6168. EchoDor had a problem when users returned from a download (using the
  6169. EchoDor %1 /R line).  Sometimes it would reset the time back to when they
  6170. first entered the door, other times it would just forget who was online.
  6171. This has hopefully been corrected.  I have been doing a lot of testing in
  6172. this area and have not seen the problem with this version.
  6173.  
  6174.  
  6175.  
  6176.  
  6177.  
  6178.  
  6179.  
  6180.  
  6181.  
  6182.  
  6183.  
  6184.  
  6185.  
  6186.  
  6187.  
  6188.  
  6189.  
  6190.                                   Page 96
  6191.  
  6192.  
  6193. EchoDor Version 3.11
  6194. 3/16/92
  6195.  
  6196.  
  6197. Run Time Errors
  6198. From time to time EchoDor or one of the support programs may run into
  6199. problems and generate a "run time" error.  The following table lists errors
  6200. and possible causes:
  6201.  
  6202. Error 001
  6203.  
  6204.      Invalid function number
  6205.  
  6206.      This can occur if your running an older version of DOS.  All versions
  6207.      of EchoDor and it's utilities require DOS 3.0 or greater.
  6208.  
  6209. Error 002
  6210.  
  6211.      File not found
  6212.  
  6213.      This is a file not found error.  If you get this first try running
  6214.      CheckOut and see if it identifies any missing files.  If no errors are
  6215.      reported by CheckOut, look through your EchoDor.Ctl file and check the
  6216.      file names on the parameters that have file names.
  6217.  
  6218. Error 003
  6219.  
  6220.      Path not found
  6221.  
  6222.      This is a path not found error.  This is very much like the file not
  6223.      found error above except this error indicates that a directory that
  6224.      you have referenced does not exist.  Correct this error like your
  6225.      correcting an 002 error.
  6226.  
  6227. Error 004
  6228.  
  6229.      Too many files open
  6230.  
  6231.      This is the "too many files open" error.  This will occur if your
  6232.      FILES=xx in your CONFIG.SYS file isn't big enough.  The xx should be
  6233.      at least 20.
  6234.  
  6235. Error 005
  6236.  
  6237.      File access denied
  6238.  
  6239.      This is a file access denied message.  If you receive this please try
  6240.      to reproduce it.  If you can reproduce it, please notify me so that I
  6241.      can fix the problem.
  6242.  
  6243. Error 006
  6244.  
  6245.      Invalid file handle
  6246.  
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.                                   Page 97
  6253.  
  6254.  
  6255. EchoDor Version 3.11
  6256. 3/16/92
  6257.  
  6258.      This is an invalid file handle error.  First try to recopy EchoDor.EXE
  6259.      (or whichever program gave you the error) from your original release
  6260.      back to your disk drive.  If you receive this error again, please
  6261.      notify me.  Have you EchoDor.Ctl file and your DoorDriv.Ctl file
  6262.      available when you call.
  6263.  
  6264. Error 012
  6265.  
  6266.      Invalid file access code
  6267.  
  6268.      This error indicates an access error.  First try to recopy EchoDor.EXE
  6269.      (or whichever program gave you the error) from your original release
  6270.      back to your disk drive.  If you receive this error again, please
  6271.      notify me.  Have your EchoDor.Ctl file and your DoorDriv.Ctl file
  6272.      available when you call.
  6273.  
  6274. Error 015
  6275.  
  6276.      Invalid drive number
  6277.  
  6278.      This error is only reported by MkDir or ChDir.  There is no MkDir or
  6279.      ChDir in EchoDor.  First try to recopy EchoDor.EXE (or whichever
  6280.      program gave you the error) from your original release back to your
  6281.      disk drive.  If you receive this error again, please notify me.  Have
  6282.      your EchoDor.Ctl file and your DoorDriv.Ctl file available when you
  6283.      call.
  6284.  
  6285. Error 016
  6286.  
  6287.      Cannot remove current directory
  6288.  
  6289.      This error is only reported by RmDir.  There is no RmDir in EchoDor.
  6290.      First try to recopy EchoDor.EXE (or whichever program gave you the
  6291.      error) from your original release back to your disk drive.  If you
  6292.      receive this error again, please notify me.  Have your EchoDor.Ctl
  6293.      file and your DoorDriv.Ctl file available when you call.
  6294.  
  6295. Error 017
  6296.  
  6297.      Cannot rename across drives
  6298.  
  6299.      This error is only reported by Rename.  There is no "Rename" in
  6300.      EchoDor.  First try to recopy EchoDor.EXE (or whichever program gave
  6301.      you the error) from your original release back to your disk drive.  If
  6302.      you receive this error again, please notify me.  Have your EchoDor.Ctl
  6303.      file and your DoorDriv.Ctl file available when you call.
  6304.  
  6305. Error 100
  6306.  
  6307.      Disk read error
  6308.  
  6309.      This will generally indicate some sort of disk problem.  To quickly
  6310.      check to see if the error is caused by a problem with one of the
  6311.      EchoDor files ... get to dos and switch to the EchoDor directory.
  6312.      Then attempt to copy all the files to the nul device:
  6313.  
  6314.                                   Page 98
  6315.  
  6316.  
  6317. EchoDor Version 3.11
  6318. 3/16/92
  6319.  
  6320.  
  6321.           COPY *.* NUL
  6322.  
  6323.      This will cause DOS to read each of the files but the copy will not
  6324.      put them anywhere.  If you get an error during the copy, replace the
  6325.      file that copy indicates is in error and try the copy again.  If you
  6326.      don't get an error when you do this, check your message base.  Go to
  6327.      the message area that the user was in when the error occured and try
  6328.      the above copy in that directory.  If a #.msg file is found to be in
  6329.      error, delete the file.  If no errors are still found, you may want to
  6330.      run a utility like NDD (Norton Disk Doctor) or DISKFIX (from
  6331.      PC-Tools).
  6332.  
  6333. Error 101
  6334.  
  6335.      Disk write error
  6336.  
  6337.      This indicates some sort of disk problem.  First check to make sure
  6338.      your not out of disk space.  Check both the drive that the message
  6339.      base is on and the drive that EchoDor is on (if different).  If you
  6340.      have sufficient space, you may want to run a utility like NDD (Norton
  6341.      Disk Doctor) or DISKFIX (from PC-Tools).
  6342.  
  6343. Error 102
  6344.  
  6345.      File not assigned
  6346.  
  6347.      This error could indicate a program problem.  First recopy EchoDor.EXE
  6348.      (or whichever program gave you the error) from your original release.
  6349.      If you still get the error, please notify me.  Have your EchoDor.Ctl
  6350.      and your DoorDriv.Ctl files available when you call.
  6351.  
  6352. Error 103
  6353.  
  6354.      File not open
  6355.  
  6356.      This error could indicate a program problem.  First recopy EchoDor.EXE
  6357.      (or whichever program gave you the error) from your original release.
  6358.      If you still get the error, please notify me.  Have your EchoDor.Ctl
  6359.      and your DoorDriv.Ctl files available when you call.
  6360.  
  6361. Error 104
  6362.  
  6363.      File not open for input
  6364.  
  6365.      This error could indicate a program problem.  First recopy EchoDor.EXE
  6366.      (or whichever program gave you the error) from your original release.
  6367.      If you still get the error, please notify me.  Have your EchoDor.Ctl
  6368.      and your DoorDriv.Ctl files available when you call.
  6369.  
  6370. Error 105
  6371.  
  6372.      File not open for output
  6373.  
  6374.  
  6375.  
  6376.                                   Page 99
  6377.  
  6378.  
  6379. EchoDor Version 3.11
  6380. 3/16/92
  6381.  
  6382.      This error could indicate a program problem.  First recopy EchoDor.EXE
  6383.      (or whichever program gave you the error) from your original release.
  6384.      If you still get the error, please notify me.  Have your EchoDor.Ctl
  6385.      and your DoorDriv.Ctl files available when you call.
  6386.  
  6387. Error 106
  6388.  
  6389.      Invalid numeric format
  6390.  
  6391.      This error could indicate a program problem.  First recopy EchoDor.EXE
  6392.      (or whichever program gave you the error) from your original release.
  6393.      If you still get the error, please notify me.  Have your EchoDor.Ctl
  6394.      and your DoorDriv.Ctl files available when you call.
  6395.  
  6396. Error 150
  6397.  
  6398.      Disk is write protected
  6399.  
  6400.      This indicates a write protected disk.  If your running from floppies,
  6401.      check to make sure there is no write protect tab on the disk.  If your
  6402.      running from hard disk, first try a reboot.  If the problem occurs
  6403.      again try copying EchoDor.EXE (or whichever program gave you the
  6404.      error) from your original release.  If the problem still occurs,
  6405.      please call me and have a copy of your EchoDor.Ctl and your
  6406.      DoorDriv.Ctl files available.
  6407.  
  6408. Error 151
  6409.  
  6410.      Unknown unit
  6411.  
  6412.      This indicates DOS could not find a specified unit.  First try a
  6413.      reboot.  If the problem occurs again try copying EchoDor.EXE (or
  6414.      whichever program gave you the error) from your original release.  If
  6415.      the problem still occurs, please call me and have a copy of your
  6416.      EchoDor.Ctl and your DoorDriv.Ctl files available.
  6417.  
  6418. Error 152
  6419.  
  6420.      Drive not ready
  6421.  
  6422.      This indicates a specified drive was not ready.  First try a reboot.
  6423.      If the problem occurs again try copying EchoDor.EXE (or whichever
  6424.      program gave you the error) from your original release.  If the
  6425.      problem still occurs, you may want to run a utility like NDD (Norton
  6426.      Disk Doctor) or DISKFIX (from PC-Tools).
  6427.  
  6428. Error 153
  6429.  
  6430.      Unknown command
  6431.  
  6432.      This indicates a drive did not understand what DOS wanted the drive to
  6433.      do.  First try a reboot.  If the problem occurs again try copying
  6434.      EchoDor.EXE (or whichever program gave you the error) from your
  6435.      original release.  If the problem still occurs, you may want to run a
  6436.      utility like NDD (Norton Disk Doctor) or DISKFIX (from PC-Tools).
  6437.  
  6438.                                  Page 100
  6439.  
  6440.  
  6441. EchoDor Version 3.11
  6442. 3/16/92
  6443.  
  6444.  
  6445. Error 154
  6446.  
  6447.      CRC error in data
  6448.  
  6449.      This indicates a problem exists when trying to read data from a file.
  6450.      First try the procedure outlined for Error 100.  If that dose not
  6451.      work, try reinstalling EchoDor.
  6452.  
  6453. Error 155
  6454.  
  6455.      Bad drive request structure lenght
  6456.  
  6457.      This is an internal DOS error.  First try a reboot.  If the problem
  6458.      occurs again try copying EchoDor.EXE (or whichever program gave you
  6459.      the error) from your original release.  If the problem still occurs,
  6460.      you may want to run a utility like NDD (Norton Disk Doctor) or DISKFIX
  6461.      (from PC-Tools).
  6462.  
  6463. Error 156
  6464.  
  6465.      Disk Seek error
  6466.  
  6467.      This is a disk problem.  First try a reboot.  If the problem occurs
  6468.      again try copying EchoDor.EXE (or whichever program gave you the
  6469.      error) from your original release.  If the problem still occurs, you
  6470.      may want to run a utility like NDD (Norton Disk Doctor) or DISKFIX
  6471.      (from PC-Tools).
  6472.  
  6473. Error 157
  6474.  
  6475.      Unknown media type
  6476.  
  6477.      This is a disk problem.  If your running from diskette, try using
  6478.      another formatted diskette.  If your running from a hard disk try a
  6479.      reboot.  If the problem occurs again try copying EchoDor.EXE (or
  6480.      whichever program gave you the error) from your original release.  If
  6481.      the problem still occurs, you may want to run a utility like NDD
  6482.      (Norton Disk Doctor) or DISKFIX (from PC-Tools).
  6483.  
  6484. Error 158
  6485.  
  6486.      Sector not found
  6487.  
  6488.      This is a disk problem.  If your running from diskette, try using
  6489.      another formatted diskette.  If your running from a hard disk try a
  6490.      reboot.  If the problem occurs again try copying EchoDor.EXE (or
  6491.      whichever program gave you the error) from your original release.  If
  6492.      the problem still occurs, you may want to run a utility like NDD
  6493.      (Norton Disk Doctor) or DISKFIX (from PC-Tools).
  6494.  
  6495. Error 159
  6496.  
  6497.      Printer out of paper
  6498.  
  6499.  
  6500.                                  Page 101
  6501.  
  6502.  
  6503. EchoDor Version 3.11
  6504. 3/16/92
  6505.  
  6506.      This will only happen if you try to do an HCOPY and your printer is
  6507.      out of paper.  Correct the problem and try again.
  6508.  
  6509. Error 160
  6510.  
  6511.      Device write fault
  6512.  
  6513.      An error occurred while trying to write to the disk or printer or
  6514.      screen.  First try a reboot.  If the problem occurs again try copying
  6515.      a new copy of EchoDor.EXE (or whichever program gave you the error)
  6516.      from your origional release.  If the problem still occurs, you may
  6517.      want to run a utility like NDD (Norton Disk Doctor) or DISKFIX (from
  6518.      PC-Tools).
  6519.  
  6520. Error 161
  6521.  
  6522.      Device read fault
  6523.  
  6524.      An error occurred while trying to write to a device.  Correct as for
  6525.      Error 160.
  6526.  
  6527. Error 162
  6528.  
  6529.      Hardware failure
  6530.  
  6531.      This is a general hardware failure.  If this occurs try First try a
  6532.      reboot.  If the problem occurs again try copying a new copy of
  6533.      EchoDor.EXE (or whichever program gave you the error) from your
  6534.      origional release.  If the problem still occurs, you may want to run a
  6535.      utility like NDD (Norton Disk Doctor) or DISKFIX (from PC-Tools).  If
  6536.      it still occurs, you may need service.
  6537.  
  6538. Errors 200-214
  6539.  
  6540.      This error could indicate a program problem.  First recopy EchoDor.EXE
  6541.      (or whichever program gave you the error) from your original release.
  6542.      If you still get the error, please notify me.  Have your EchoDor.Ctl
  6543.      and your DoorDriv.Ctl files available when you call.
  6544.  
  6545.  
  6546.  
  6547.  
  6548.  
  6549.  
  6550.  
  6551.  
  6552.  
  6553.  
  6554.  
  6555.  
  6556.  
  6557.  
  6558.  
  6559.  
  6560.  
  6561.  
  6562.                                  Page 102
  6563.  
  6564.  
  6565. EchoDor Version 3.11
  6566. 3/16/92
  6567.  
  6568.  
  6569. Plans for next version
  6570.  
  6571. Further ability in the EchoNLCP compiler.
  6572.  
  6573. UNIX e-mail and news group support.  With this addition EchoDor will
  6574. understand how to write message to be understood by UUCP.
  6575.  
  6576. Time estimates for downloads.
  6577.  
  6578.  
  6579.  
  6580.  
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.  
  6590.  
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.  
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604.  
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.  
  6611.  
  6612.  
  6613.  
  6614.  
  6615.  
  6616.  
  6617.  
  6618.  
  6619.  
  6620.  
  6621.  
  6622.  
  6623.  
  6624.                                  Page 103
  6625.  
  6626.  
  6627. EchoDor Version 3.11
  6628. 3/16/92
  6629.  
  6630.  
  6631. Registration
  6632.  
  6633. EchoDor represents MANY hours of work and if you find it useful, I would
  6634. appreciate your sending in a donation of $25 or more.  I will send you back
  6635. a DSDD 5.25" disk or a 3.5" disk with a registration key and perhaps a few
  6636. other small utilities that will fit on it. This registration key can be
  6637. used with the current and all future releases of EchoDor.
  6638.  
  6639. My mailing address is:
  6640.  
  6641.           Robert McCullough
  6642.           P.O. Box 101095
  6643.           Nashville, TN  37224-1095
  6644.  
  6645. My voice telephone number is:
  6646.  
  6647.           615 256-2444
  6648.  
  6649.      If your going to call me, please remember that I live in the central
  6650.      time zone.
  6651.  
  6652. When you register, please send me you name, address, voice phone, BBS name,
  6653. BBS type, BBS phone, and where you got EchoDor.  Also, if you send me
  6654. either a FidoNet or RBBSNet node number, I can send you the key via net
  6655. mail.
  6656.  
  6657. I'd like to thank the people that have supported EchoDor through their
  6658. registration.  I will continue to support the users of EchoDor in a
  6659. professional maner and will hope to receive your support in return.
  6660.  
  6661. Also, if you use RASMAM be sure to follow the authors registration
  6662. requirements.  Registration of EchoDor does NOT give you a registration to
  6663. RASMAM.
  6664.  
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.  
  6671.  
  6672.  
  6673.  
  6674.  
  6675.  
  6676.  
  6677.  
  6678.  
  6679.  
  6680.  
  6681.  
  6682.  
  6683.  
  6684.  
  6685.  
  6686.                                  Page 104
  6687.  
  6688.  
  6689. EchoDor Version 3.11
  6690. 3/16/92
  6691.  
  6692.  
  6693. Disclaimer
  6694.  
  6695. This program is being distributed under the following conditions:
  6696.  
  6697. 1.   This code or any of the files associated with it may not be
  6698.      distributed in modified form in any way.  You may archive this program
  6699.      and it's associated files in any manor that is suitable for your BBS.
  6700.      Please do not delete any files from the archive.
  6701.  
  6702. 2.   You may not use any portion of the code distributed with this package
  6703.      in any other program without my written permission.
  6704.  
  6705. 3.   This software and/or code may not be distributed for a profit.  This
  6706.      does not exclude the archive from being on a pay for use BBS.
  6707.  
  6708. 4.   I am in no way responsible for any damage that may be caused due to
  6709.      the use or misuse of this software.  The user assumes all
  6710.      responsibility for any damages and holds the author harmless.
  6711.  
  6712.  
  6713.  
  6714.  
  6715.  
  6716.  
  6717.  
  6718.  
  6719.  
  6720.  
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.  
  6728.  
  6729.  
  6730.  
  6731.  
  6732.  
  6733.  
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.  
  6740.  
  6741.  
  6742.  
  6743.  
  6744.  
  6745.  
  6746.  
  6747.  
  6748.                                  Page 105
  6749.  
  6750.  
  6751. EchoDor Version 3.11
  6752. 3/16/92
  6753.  
  6754.  
  6755. Guarantee
  6756.  
  6757.      There is absolutely no guarantee, warranty or promise of any kind made
  6758.      with regard to the performance or quality of the EchoDor software,
  6759.      utilities, documentation, or any associated files. Any problems,
  6760.      risks, damages, disasters or lack of them are purely you're
  6761.      responsibility.  By using this software, documentation, utilities, or
  6762.      any associated materials, you acknowledge this in full.
  6763.  
  6764.  
  6765.  
  6766.  
  6767.  
  6768.  
  6769.  
  6770.  
  6771.  
  6772.  
  6773.  
  6774.  
  6775.  
  6776.  
  6777.  
  6778.  
  6779.  
  6780.  
  6781.  
  6782.  
  6783.  
  6784.  
  6785.  
  6786.  
  6787.  
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.  
  6794.  
  6795.  
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.  
  6808.  
  6809.  
  6810.                                  Page 106